Webhook Endpoints

Test-fire a webhook endpoint

Enqueues a synthetic subscription.created-shaped delivery against the endpoint and answers 202 Accepted. The row is handed to the delivery worker immediately, so it shows up in Settings → Webhook Deliveries and moves to delivered or failed as soon as your handler answers. Rate-limited to 5 fires per minute per endpoint.

post/v1/webhook-endpoints/{endpoint}/test

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/webhook-endpoints/{endpoint}/test
  • Auth: HTTP bearer

Path parameters

endpointstring uuid required

The endpoint, resolved by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Response

202 with the new delivery's id and status.

Example response

{
  "data": {
    "delivery_id": "34f1d78e-05a2-4b69-8c3d-7e921ab06f45",
    "status": "pending",
    "enqueued_at": "2026-05-18T10:05:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.