# Ping (https://docs.pulsarml.com/v1/api-reference/webhooks/ping)

Sent when Pulsar tests your endpoint. It can reach an endpoint whatever event type it's registered for, so reply `2XX` to it rather than rejecting event types you didn't expect.

## Webhook: `Ping`

Pulsar sends a `POST` request with this body to the HTTPS endpoint you registered for the `Ping` event. Verify `X-Pulsar-Signature` before trusting it; see https://docs.pulsarml.com/webhooks/signatures.

### Header parameters

- `X-Pulsar-Signature` (string, required, e.g. `"5c0e2f4a1b9d8e7f6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f"`) — HMAC-SHA256 signature of the raw body. Verify it before trusting the request; see Verify signatures.
- `X-Pulsar-Event-Type` (string, required, e.g. `"Ping"`) — The event type, same as `eventType` in the body.
- `X-Pulsar-Event-Id` (string, required, e.g. `"8d2f6c1e-4b7a-4f0e-9a3c-5e1d7b9f2a64"`) — The event's ID, same as `eventId` in the body.
- `X-Pulsar-Timestamp` (string, required, e.g. `"2026-09-25T14:03:12.482Z"`) — Same as `eventTimestamp` in the body.
- `X-Pulsar-Request-Id` (string, required, e.g. `"3f9b2c7d-1e4a-4c8b-b6d2-9a0e5f7c1b38"`) — The ID of this delivery attempt. Include it when you contact Pulsar support about a delivery.

### Request body (`application/json`, required)

Type: object

- `eventId` (string (uuid), required) — Unique ID of the event. It stays the same across retries, so use it to detect duplicates.
- `eventTimestamp` (string (date-time), required) — When Pulsar queued the event, as an ISO 8601 UTC timestamp. This is not the time the change happened in Pulsar.
- `eventType` ("Ping", required) — The event type.
- `event` (object, required)
  - `text` ("ping", required) — Always `ping`.

### Your response

#### 200 — Return any `2XX` within 10 seconds to acknowledge the delivery; Pulsar ignores the response body. A timeout, `408`, `429` or `5XX` is retried. Any other `4XX`, or a `3XX` redirect, is not.

### Example body

```json
{
  "eventId": "0b6f3d2a-9c1e-4a7b-8f5d-2e4c6a8b0d1f",
  "eventTimestamp": "2026-09-25T14:00:00.000Z",
  "eventType": "Ping",
  "event": {
    "text": "ping"
  }
}
```