Webhooks

Event: test.ping

Sent when you call POST /v1/webhooks/{webhook_id}/test. Delivered even to disabled endpoints so you can verify your receiver (including signature verification) before enabling. Endpoints receive test.ping regardless of their event subscription.

postWebhooktest.ping

Payload

idstring

Event ID (evt_...). Stable across retries — use it as an idempotency key.

object'event'

type'test.ping'

Event type (e.g. message.relayed, test.ping)

api_versionstring

Payload schema version

createdstring date-time

When the event occurred (use this, not arrival order)

account_idstring

The account the event belongs to

Example payload

{
  "id": "evt_01J9XK4T8Q2M5N7P",
  "api_version": "2026-08",
  "data": {
    "message": "Winnr webhook test"
  }
}

Response

Return any 2xx status within 10 seconds to acknowledge the event.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.