---
title: "Send a synthetic test delivery"
method: POST
path: "/webhook-endpoints/{id}/test"
tags: ["Webhooks"]
---

# Send a synthetic test delivery

`POST /webhook-endpoints/{id}/test`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/webhook-endpoints/{id}/test`
- Auth: HTTP bearer

Sends one unmistakably synthetic signed delivery to the endpoint URL and returns a sanitized outcome. Never copies real domain data.

## Path parameters

- `id` string, required: The webhook endpoint ID.

## Response `200`

Test delivery attempted.

- WebhookTestDelivery
  - `object` 'webhook_test_delivery', required
  - `delivered` boolean, required
  - `status` number, nullable, required
  - `status_class` string, required
  - `latency_ms` number, required
  - `diagnostic` string, required

## Other responses

- `402`: The board's plan does not include webhooks (`plan_upgrade_required`). Webhooks require a paid plan, Starter and above.
- `403`: Missing webhooks.manage or a family read scope.
- `404`: Endpoint not found.

## Changes

- **2026-10-19** `c34152c38176`: 3 info
  - added the optional property `error/upgrade` to the response with the `402` status
  - added the optional property `error/upgrade` to the response with the `403` status
  - added the optional property `error/upgrade` to the response with the `404` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/webhook-endpoints/:id/test/post.md)

---

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