Webhooks
List Webhooks
List all webhook endpoints
GET
Request
Retrieve a list of all webhook endpoints configured for your account.Headers
Bearer token for authentication. Format:
Bearer YOUR_API_KEYQuery Parameters
Number of webhooks to return (1-100)
Pagination cursor from a previous response
Filter by status:
active, inactive, failingResponse
Array of webhook objects
Whether there are more results available
Cursor for fetching the next page
Total number of webhooks
Webhook Object
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier |
url | string | Webhook endpoint URL |
events | array | Subscribed event types |
description | string | Description of the webhook |
status | string | active, inactive, or failing |
last_triggered_at | string | Last time webhook was triggered |
failure_count | integer | Consecutive failures (when failing) |
created_at | string | ISO 8601 timestamp |
Webhook Status
| Status | Description |
|---|---|
active | Webhook is receiving events normally |
inactive | Webhook is disabled |
failing | Webhook has consecutive delivery failures |
Webhooks automatically enter
failing status after 5 consecutive delivery failures.
They will be automatically disabled after 100 consecutive failures.Error Codes
| Code | Description |
|---|---|
invalid_cursor | The pagination cursor is invalid |
invalid_status | Status must be ‘active’, ‘inactive’, or ‘failing’ |