Update a Webhook Endpoint
Updates a webhook endpoint's URL, events, or active state.
PATCHhttps://api.audienceful.com/v2/webhooks/{id}
curl --location --request PATCH 'https://api.audienceful.com/v2/webhooks/wYt3nKq8Zs4pLm9vRb2xJc' \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <your-api-key>' \
--data-raw '{
"events": ["person.created", "person.updated", "audience.member_added"],
"is_active": true
}'{
"id": "wYt3nKq8Zs4pLm9vRb2xJc",
"url": "https://example.com/webhooks/audienceful",
"events": ["person.created", "person.updated", "audience.member_added"],
"is_active": true,
"disabled_reason": null,
"disabled_at": null,
"consecutive_failures": 0,
"created_at": "2026-07-04T12:00:00Z",
"updated_at": "2026-07-04T13:15:00Z"
}Requires the webhooks:write scope. Send only the fields you want to change.
Path parameters
idstringrequired
The id of the webhook endpoint.
Body
urlstring
A new HTTPS URL for deliveries.
eventsarray[string]
Replace the events this endpoint is subscribed to. Must be a non-empty list of valid event names.
is_activeboolean
Enable or disable the endpoint. Setting
is_active: true on a disabled endpoint re-enables it and clears its failure state (disabled_reason, disabled_at, and consecutive_failures are reset).Response
Returns the updated endpoint. The secret is not returned.
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