List Webhook Endpoints

Returns a cursor-paginated list of your webhook endpoints.

GEThttps://api.audienceful.com/v2/webhooks

curl --location --request GET 'https://api.audienceful.com/v2/webhooks' \
--header 'X-Api-Key: <your-api-key>'

{
  "data": [
    {
      "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"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Requires the webhooks:read scope. The signing secret is never returned here — it is only shown once, when the endpoint is created.

Query parameters

page_sizenumberdefault: 100

The number of endpoints to return per page.

cursorstring

The pagination cursor from a previous response's next_cursor. See Pagination.

Response

dataarray

The page of webhook endpoints.

Properties

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.

has_moreboolean

Whether more endpoints exist after this page.

next_cursorstring or null

The cursor to pass as ?cursor= to fetch the next page.