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

# Send a test payload

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

<small>_Requires the `webhooks:operate` scope (or a broader one that includes it)._</small>

Triggers a synthetic delivery to the subscription's URL so the integrator can
validate wiring. Only enabled subscriptions can be tested.

## Path parameters

- `id` integer, required

## Response `204`

Test payload dispatched. The response body is empty.

- unknown

## Other responses

- `400` — Invalid `id` parameter.
- `401` — Unauthorized. The response body is empty; check the `WWW-Authenticate` header for the expected scheme.
- `404` — Subscription not found, not owned by the caller, or disabled.
- `429` — Too Many Requests
- `502` — The webhook subscription is valid and the request was dispatched, but the target URL could not be reached or rejected the delivery. Causes include connection failures, TLS handshake errors, the target returning a 4xx or 5xx, or the request timing out. The subscription is left untouched — the integrator should fix the target endpoint and retry the test.

---

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