Webhook events
ping
Only from a test send.
Event type: ping.
When it fires
Only from a test send.
Envelope
Every event shares these top-level fields. The event-specific fields are under data.
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Unique event id. Deliveries are at-least-once, so dedupe on it. |
type | "ping" | Yes | |
createdAt | string (date-time) | Yes | |
apiVersion | "v1" | Yes | |
organizationId | integer | Yes | |
brandId | integer | null | Yes | |
accountId | string | null | Yes | The ad account the event concerns. |
provider | string | null | Yes | The ad platform the event happened on. One of meta, whop. |
Data
| Field | Type | Required | Description |
|---|---|---|---|
data.message | string | Yes |
Example payload
{
"id": "evt_2xKq7Vb9mN4pR8sT",
"type": "ping",
"createdAt": "2026-09-19T14:30:00Z",
"apiVersion": "v1",
"organizationId": 1,
"brandId": 1,
"accountId": "string",
"provider": "meta",
"data": {
"message": "string"
}
}Delivery headers
| Header | Required | Description |
|---|---|---|
webhook-id | Yes | The delivery id; identical across retries of the same event. Dedupe on the envelope id. |
webhook-timestamp | Yes | Unix seconds at signing time. Reject deliveries older than 5 minutes. |
webhook-signature | Yes | Space-separated v1,<base64 HMAC-SHA256> signatures (Standard Webhooks). Two are sent while a rotated secret overlaps. |
Acknowledge
| Your response | Meaning |
|---|---|
2XX | Return any 2xx status to acknowledge the delivery. |
Signing, retries and endpoint setup are in the Webhooks guide.