Retrieve a Webhook Endpoint
Retrieves a single webhook endpoint by its id.
GEThttps://api.audienceful.com/v2/webhooks/{id}
curl --location --request GET 'https://api.audienceful.com/v2/webhooks/wYt3nKq8Zs4pLm9vRb2xJc' \
--header 'X-Api-Key: <your-api-key>'{
"id": "wYt3nKq8Zs4pLm9vRb2xJc",
"url": "https://example.com/webhooks/audienceful",
"events": ["person.created", "person.updated"],
"is_active": true,
"disabled_reason": null,
"disabled_at": null,
"consecutive_failures": 0,
"created_at": "2026-07-04T12:00:00Z",
"updated_at": "2026-07-04T12:00:00Z"
}Requires the webhooks:read scope. The signing secret is not returned.
Path parameters
idstringrequired
The id of the webhook endpoint.
Response
idstring
The webhook endpoint's unique id.
urlstring
The HTTPS URL deliveries are POSTed to.
eventsarray[string]
The events this endpoint is subscribed to.
is_activeboolean
Whether the endpoint is currently active. A disabled endpoint receives no deliveries.
disabled_reasonstring or null
Why the endpoint was disabled, if it is. One of
manual, 410_gone, or too_many_failures. null when active.disabled_atstring or null
The datetime (UTC) the endpoint was disabled, if it is.
consecutive_failuresnumber
The number of consecutive failed deliveries. Resets to
0 on a successful delivery or when the endpoint is re-enabled.created_atstring
The datetime (UTC) the endpoint was created.
updated_atstring
The datetime (UTC) the endpoint was last updated.
Last updated: July 11, 2026