Browse documentation
Reference
REST API
The API uses predictable resource URLs, JSON bodies, and bearer authentication. All requests must use HTTPS.
Authentication
Create an API key in Settings → API keys, then send it as a bearer token. Keys are scoped and can be revoked at any time.
Authorization header
curl "https://api.hooks.events/v1/endpoints" \
-H "Authorization: Bearer $HOOKS_API_KEY"Endpoints
| Method | Path | Purpose |
|---|---|---|
GET | /v1/endpoints | List endpoints and their status. |
POST | /v1/endpoints | Create an endpoint and signing secret. |
GET | /v1/events | Query events by endpoint, type, or time. |
GET | /v1/deliveries | List delivery attempts and response codes. |
POST | /v1/deliveries/{id}/retry | Replay a failed delivery. |
Responses are paginated with a cursor. Pass ?limit=50&cursor=…to fetch the next page. The default page size is 25.
Was this page helpful?
Tell us if something was missing or unclear.
Ready to try it?Create a free workspace and send your first event.