Test Webhook

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);

POST

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

The ping your endpoint receives:

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

Overview

Agency

Chatbot

Analytics

Conversation History

Updated Answers

Leads

Suggested Messages

Query

Sources

User

Path Parameters

Headers

Response

​Path Parameters

​Headers

​Response

Path Parameters

Headers

Response