---
title: "Event: test.ping"
method: POST
path: "test.ping"
tags: ["Webhooks"]
---

# Event: test.ping

`POST test.ping` (webhook)

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.

## Payload

- object: The envelope every webhook delivery POSTs to your endpoint. Per-event `data` shapes are documented in the top-level `webhooks` section. Delivery notes: deliveries are at-least-once (dedupe on `id`), may arrive out of order (use `created`), and must be acknowledged with a 2xx response within 10 seconds. Verify authenticity via the `X-Winnr-Signature` header before trusting the payload.
  - `id` string: 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_version` string: Payload schema version
  - `created` string, date-time: When the event occurred (use this, not arrival order)
  - `account_id` string: The account the event belongs to
  - `data` object: Event-specific payload
    - `message` string
    - `webhook_id` string: The endpoint the test was sent to

## Acknowledgement `200`

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

---

[API](https://skmtc.dev/winnr/apis/winnr-api.md) · [All operations](https://skmtc.dev/winnr/apis/winnr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winnr/apis/winnr-api/revisions/a4f960beb1eb?raw)