Skip to main content

Anonymous Endpoints API

Create temporary debug endpoints that don't require authentication. Useful for quick testing and demos.

Create an anonymous endpoint​

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

No authentication required.

Response: 201 Created

{
  "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"
}

Get an anonymous endpoint​

GET /api/v1/anon/endpoints/:id
curl https://app.hooklistener.com/api/v1/anon/endpoints/anon_abc123

No authentication required.

Send a webhook to an anonymous endpoint​

ANY /anon/:id
curl -X POST https://app.hooklistener.com/anon/anon_abc123 \
  -H "Content-Type: application/json" \
  -d '{"event": "test", "data": {"message": "Hello"}}'

All HTTP methods are supported.

List captured events​

GET /api/v1/anon/endpoints/:endpoint_id/events
curl https://app.hooklistener.com/api/v1/anon/endpoints/anon_abc123/events

Response:

[
  {
    "id": "evt_def456",
    "method": "POST",
    "headers": {"content-type": "application/json"},
    "body": "{\"event\":\"test\"}",
    "remote_address": "192.168.1.1",
    "created_at": "2025-01-15T10:35:00Z"
  }
]

Get a specific event​

GET /api/v1/anon/endpoints/:endpoint_id/events/:event_id
curl https://app.hooklistener.com/api/v1/anon/endpoints/anon_abc123/events/evt_def456

Limitations​

  • Anonymous endpoints expire after 24 hours
  • No authentication required (anyone with the URL can send/view events)
  • Limited event retention
  • No forwarding, mock responses, or sharing features