Test Webhook

Send a test delivery to verify your endpoint is reachable and configured correctly.

Endpoint

POST /v3/webhooks/:id/test

Sends a synthetic event with "test": true in the payload. The event type is the first one in your webhook’s event_types list.

Example

curl -X POST https://api.polynode.dev/v3/webhooks/wh_451e06ca0534/test \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "delivered": true,
  "status_code": 200,
  "latency_ms": 89
}

Test Payload

Your endpoint receives:

{
  "id": "test_a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "type": "trade",
  "created_at": "2026-05-14T15:00:00+00:00",
  "data": {
    "test": true,
    "message": "This is a test delivery from polynode webhooks"
  }
}

The delivery includes all standard webhook headers (X-Webhook-ID, X-Webhook-Event, X-Webhook-Timestamp, X-Webhook-Signature) so you can verify your signature validation logic.