---
title: "Test a webhook delivery"
method: POST
path: "/v1/webhooks/{webhook_id}/test"
tags: ["Webhooks"]
---

# Test a webhook delivery

`POST /v1/webhooks/{webhook_id}/test`

Send a synthetic notification to the webhook endpoint. Uses the same payload format as real deliveries with a fixed event ID.

## Path parameters

- `webhook_id` string, required

## Request body

- TestWebhookRequestDto — Request body for testing a webhook delivery. Sends a synthetic notification to the webhook endpoint using the same format as real deliveries. The event ID is a fixed identifier to distinguish test payloads.
  - `event_type` string, nullable — Event type to simulate. If omitted, defaults to the event type the webhook is subscribed to.

## Response `200`

Test delivery completed

- TestWebhookResponseDto — Response from testing a webhook delivery. Contains the delivery result and the exact notification payload that was sent to the endpoint.
  - `success` boolean, required — Whether the test delivery succeeded (endpoint returned a 2xx status code).
  - `delivery` TestDeliveryResultDto, required — Delivery result from a test webhook request.
    - `status_code` integer, required — HTTP status code returned by the webhook endpoint.
    - `response_time_ms` integer, required — Round-trip response time in milliseconds.
    - `timestamp` string, required — Timestamp when delivery was attempted (ISO 8601).
  - `payload` EventNotificationDto, required — Thin notification payload matching webhook delivery format. This is the same structure delivered to webhook endpoints. Test deliveries use a fixed event ID.
    - `event_id` string, required — Unique event identifier.
    - `event_type` string, required — Event type that triggered this notification, in `category.*` format.
    - `links` EventLinkDto[], required — Versioned links to retrieve the full event detail from the Historical Events API.
      - `version` string, required — API version for the linked resource.
      - `url` string, required — URL to fetch the full event detail from the Historical Events API.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.dev/whitepages/apis/whitepages-api-reference.md) · [All operations](https://skmtc.dev/whitepages/apis/whitepages-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whitepages/whitepages-api-reference/revisions/c27a0cd8718f/schema)