Skip to main content

Anonymous Endpoints

Anonymous endpoints are temporary debug endpoints that don't require authentication. They're useful for quick testing, demos, or when you need a throwaway webhook URL.

Creating an anonymous endpoint​

From the API​

curl -X POST https://app.hooklistener.com/api/v1/anon/endpoints \
  -H "Content-Type: application/json"

Response:

{
  "id": "anon_abc123",
  "webhook_url": "https://app.hooklistener.com/anon/anon_abc123",
  "created_at": "2025-01-15T10:30:00Z",
  "expires_at": "2025-01-16T10:30:00Z"
}

No API key or authentication is needed.

Sending webhooks​

Send requests to the anonymous endpoint URL:

curl -X POST https://app.hooklistener.com/anon/<id> \
  -H "Content-Type: application/json" \
  -d '{"event": "test"}'

Viewing captured events​

Get endpoint details​

curl https://app.hooklistener.com/api/v1/anon/endpoints/<id>

List captured events​

curl https://app.hooklistener.com/api/v1/anon/endpoints/<id>/events

Get a specific event​

curl https://app.hooklistener.com/api/v1/anon/endpoints/<id>/events/<event-id>

Limitations​

Anonymous endpoints have several restrictions compared to authenticated endpoints:

FeatureAnonymousAuthenticated
Authentication requiredNoYes
LifetimeTemporary (24 hours)Persistent
Request forwardingNoYes
Mock responsesNoYes
Request sharingNoYes
CSV exportNoYes
CLI integrationNoYes

Use cases​

  • Quick testing — get a webhook URL in seconds without signing up
  • Demos — show webhook functionality without account setup
  • One-off debugging — capture a few requests and move on
  • CI/CD pipelines — create temporary endpoints for integration tests