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

import requests

url = "https://api.audienceful.com/v2/webhooks"
headers = {
    "X-Api-Key": "<your-api-key>",
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.audienceful.com/v2/webhooks", {
  method: "GET",
  headers: {
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(data);

{
  "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_size
number
default:"100"
The number of endpoints to return per page.
​
cursor
string
The pagination cursor from a previous response’s next_cursor. See Pagination.

​
Response

​
data
array
The page of webhook endpoints.
​
has_more
boolean
Whether more endpoints exist after this page.
​
next_cursor
string or null
The cursor to pass as ?cursor= to fetch the next page.
curl --location --request GET 'https://api.audienceful.com/v2/webhooks' \
--header 'X-Api-Key: <your-api-key>'

import requests

url = "https://api.audienceful.com/v2/webhooks"
headers = {
    "X-Api-Key": "<your-api-key>",
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://api.audienceful.com/v2/webhooks", {
  method: "GET",
  headers: {
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(data);

{
  "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
}