---
title: "Send a single test event to the configured webhook"
method: POST
path: "/v1/webhook/test"
---

# Send a single test event to the configured webhook

`POST /v1/webhook/test`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/webhook/test`
- Auth: HTTP bearer

Sends one test attempt to the configured URL, REGARDLESS of the `events` filter from `PUT /v1/webhook` - this tests deliverability, not the subscription. No retry; even a failure gets recorded in the delivery history. At most 10 per hour.

## Response `200`

Test result

- object
  - `delivered` boolean, required
  - `status` number, nullable, required
  - `attempts` 1, required
  - `durationMs` number, required

## Other responses

- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `404`: Error codes: not_found (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

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