> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.getdial.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getdial.ai/_mcp/server.

# webhook.ping

> A test event Dial sends to a single webhook subscription on demand.

`webhook.ping` is a synthetic event you trigger yourself — from the
[dashboard Webhooks page](https://getdial.ai/dashboard/webhooks) **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](/documentation/platform/webhooks#verify-the-signature)
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.

| Field           | Type           | Description                                                |
| --------------- | -------------- | ---------------------------------------------------------- |
| `id`            | string         | The event ID (also in `X-Dial-Event-ID`). Unique per ping. |
| `object`        | string         | Always `"event"`.                                          |
| `type`          | string         | Always `webhook.ping`.                                     |
| `version`       | integer        | Always `1`.                                                |
| `createdAt`     | string         | ISO-8601 timestamp of when the ping was fired.             |
| `relatedObject` | object \| null | Always `null` — a ping has no underlying resource.         |
| `data`          | object         | Always `{}`.                                               |

```json
{
  "id": "evt_3f9a…",
  "object": "event",
  "type": "webhook.ping",
  "version": 1,
  "createdAt": "2026-06-03T12:00:00.000Z",
  "relatedObject": null,
  "data": {}
}
```

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