---
title: "Send a test event"
method: POST
path: "/v3/webhooks/{id}/test"
tags: ["Webhooks"]
---

# Send a test event

`POST /v3/webhooks/{id}/test`

Delivers a sample payload to the webhook url and returns the response, so the endpoint and
its signature verification can be validated without waiting for a real event. The delivery
is not recorded as a webhook event log and never suspends the webhook, whatever the outcome.

## Path parameters

- `id` string, required

## Request body

- WebhookTestRequestModel
  - `event` string, nullable — The event to send a sample payload for. Defaults to the first event the webhook is subscribed to.

## Response `200`

OK

- WebhookTestResultDto — Outcome of a test event delivery. Returned inline instead of being persisted as a webhook event log, so test deliveries never affect the health of the webhook.
  - `succeeded` boolean, required — Whether the endpoint responded with a success status code.
  - `url` string, required — The endpoint the test payload was delivered to.
  - `event` string, required — The event the test payload was sent for.
  - `requestBody` string, required — The exact body which was signed and sent, so the signature can be reproduced.
  - `signature` string, required — The value sent in the 'webhook-signature' header.
  - `responseStatusCode` integer, nullable — The status code returned by the endpoint, null if no response was received.
  - `responseBody` string, nullable — The response body returned by the endpoint, truncated to 4096 characters.
  - `errorMessage` string, nullable — The reason the delivery failed, null when it succeeded.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `429` — Too Many Requests
- `500` — Server Error

---

[API](https://skmtc.net/cryptlex/apis/cryptlex-web-api.md) · [All operations](https://skmtc.net/cryptlex/apis/cryptlex-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cryptlex/cryptlex-web-api/revisions/66dcb6293180/schema)