curl -X POST "https://api.sitespeak.ai/v1/agency/webhooks/{webhook_id}/test" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
const response = await fetch(
'https://api.sitespeak.ai/v1/agency/webhooks/{webhook_id}/test',
{
method: 'POST',
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer YOUR_API_TOKEN'
}
}
);
const data = await response.json();
console.log(data);
Agency
Test Webhook
Sends a signed ping event so you can verify your endpoint
POST
/
v1
/
agency
/
webhooks
/
{webhook_id}
/
test
curl -X POST "https://api.sitespeak.ai/v1/agency/webhooks/{webhook_id}/test" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
const response = await fetch(
'https://api.sitespeak.ai/v1/agency/webhooks/{webhook_id}/test',
{
method: 'POST',
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer YOUR_API_TOKEN'
}
}
);
const data = await response.json();
console.log(data);
Available on agency plans. The API token must belong to the agency owner.
Queues a
The ping your endpoint receives:
ping event to the endpoint, signed exactly like real events, so you can verify your endpoint and signature handling end to end. Check the result with the deliveries endpoint.
Path Parameters
| Name | Type | Description |
|---|---|---|
| webhook_id* | String | The ID of the webhook. |
Headers
| Name | Type | Description |
|---|---|---|
| Accept* | String | application/json |
| Authorization* | String | Bearer |
curl -X POST "https://api.sitespeak.ai/v1/agency/webhooks/{webhook_id}/test" \
-H "Accept: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
const response = await fetch(
'https://api.sitespeak.ai/v1/agency/webhooks/{webhook_id}/test',
{
method: 'POST',
headers: {
'Accept': 'application/json',
'Authorization': 'Bearer YOUR_API_TOKEN'
}
}
);
const data = await response.json();
console.log(data);
Response
- 202 Accepted
- 422 Inactive
{
"delivery_id": "be5b6e75-258d-4e97-a4fa-e02e6daf0267"
}
{
"message": "This webhook is inactive. Activate it before sending a test."
}
{
"id": "be5b6e75-258d-4e97-a4fa-e02e6daf0267",
"event": "ping",
"timestamp": "2026-08-18T11:42:01+00:00",
"team_id": null,
"external_reference": null,
"chatbot_id": null,
"data": {
"message": "SiteSpeak webhook test"
}
}
Last modified on August 18, 2026