webhook.ping

View as Markdown

webhook.ping is a synthetic event you trigger yourself — from the dashboard Webhooks page Fire ping button or POST /api/v1/webhooks/{id}/ping. It is delivered only to the targeted subscription and ignores that subscription’s eventTypes filter, so you can confirm an endpoint is reachable and verifying signatures without waiting for a real event.

It is never delivered to a subscription unless you explicitly fire it, and you cannot subscribe to it.

Payload

Like every event, webhook.ping uses the standard envelope. It has no underlying resource, so relatedObject is null and data is empty.

FieldTypeDescription
idstringThe event ID (also in X-Dial-Event-ID). Unique per ping.
objectstringAlways "event".
typestringAlways webhook.ping.
versionintegerAlways 1.
createdAtstringISO-8601 timestamp of when the ping was fired.
relatedObjectobject | nullAlways null — a ping has no underlying resource.
dataobjectAlways {}.
1{
2 "id": "evt_3f9a…",
3 "object": "event",
4 "type": "webhook.ping",
5 "version": 1,
6 "createdAt": "2026-06-03T12:00:00.000Z",
7 "relatedObject": null,
8 "data": {}
9}

When your endpoint returns 2xx for a ping, the subscription’s Last ping time updates in the dashboard.