List webhook endpoints
Returns the community's webhook endpoints. Signing secrets are never included.
Authorization
apiKey Community-scoped API key. Send it as Authorization: Bearer arclt_live_.... Keys carry scopes; endpoints that need a specific scope answer 403 missing_scope when the key lacks it.
In: header
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/v1/webhooks/endpoints"{
"data": [
{
"id": "whep_01JMZXB3C4",
"server_id": "srv_01JMZX0000",
"url": "https://example.com/webhooks/arcalotl",
"description": "Production billing sync",
"event_types": [
"subscription.active",
"subscription.cancelled"
],
"enabled": true,
"consecutive_failures": 0,
"disabled_at": "2019-08-24T14:15:22Z",
"disabled_reason": "string",
"created_at": "2026-06-01T12:00:00Z",
"updated_at": "2026-07-01T12:00:00Z"
}
]
}{
"type": "https://docs.arcalotl.com/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource was not found.",
"code": "not_found"
}{
"type": "https://docs.arcalotl.com/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource was not found.",
"code": "not_found"
}{
"type": "https://docs.arcalotl.com/api/errors#not_found",
"title": "Not Found",
"status": 404,
"detail": "The requested resource was not found.",
"code": "not_found"
}GETList the machine-readable event-type catalog
The authoritative catalog of public event types and their descriptions. Use it to populate `event_types` on an endpoint. Available to any authenticated key.
POSTCreate a webhook endpoint
Registers an endpoint and returns the `whsec_` signing secret exactly once, in the response body. Store it now; it cannot be retrieved again. Requires webhooks:write. Max 5 endpoints per community (`422 endpoint_limit` beyond that).