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

import requests

url = "https://api.audienceful.com/v2/webhooks/wYt3nKq8Zs4pLm9vRb2xJc"
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/wYt3nKq8Zs4pLm9vRb2xJc", {
  method: "GET",
  headers: {
    "X-Api-Key": "<your-api-key>",
  },
});
const data = await response.json();
console.log(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"
}
Requires the webhooks:read scope. The signing secret is not returned.

​
Path parameters

​
id
string
required
The id of the webhook endpoint.

​
Response

​
id
string
The webhook endpoint's unique id.
​
url
string
The HTTPS URL deliveries are POSTed to.
​
events
array[string]
The events this endpoint is subscribed to.
​
is_active
boolean
Whether the endpoint is currently active. A disabled endpoint receives no deliveries.
​
disabled_reason
string or null
Why the endpoint was disabled, if it is. One of manual, 410_gone, or too_many_failures. null when active.
​
disabled_at
string or null
The datetime (UTC) the endpoint was disabled, if it is.
​
consecutive_failures
number
The number of consecutive failed deliveries. Resets to 0 on a successful delivery or when the endpoint is re-enabled.
​
created_at
string
The datetime (UTC) the endpoint was created.
​
updated_at
string
The datetime (UTC) the endpoint was last updated.
curl --location --request GET 'https://api.audienceful.com/v2/webhooks/wYt3nKq8Zs4pLm9vRb2xJc' \
--header 'X-Api-Key: <your-api-key>'

import requests

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