API · Webhooks

Replay Event

Queue one manual delivery of an event to an enabled webhook, preserving its ID and any automatic retries (requires full access). Disabled webhooks return 422, and the manual attempt does not create further retries.

POST/webhooks/{webhook_id}/events/{event_id}/replayFull access

Request parameters

Parameter	Type	Description
`webhook_id` path · required	`string`	The Webhook ID.
`event_id` path · required	`string`	The Webhook Event ID.
`Idempotency-Key` header · optional	`string` 1–256 characters	Makes the request safe to retry. See Idempotency.

Request example

Set OPENSEND_BASE_URL=https://api.example.com and OPENSEND_API_KEY=os_replace_me on your server.

bash

curl -X POST "$OPENSEND_BASE_URL/webhooks/YOUR_webhook_id/events/YOUR_event_id/replay" \
  -H "Authorization: Bearer $OPENSEND_API_KEY"

Response

200 · application/json. Example IDs stand for IDs returned by your installation.

json

{
  "object": "webhook_event",
  "id": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga2"
}

Behavior and errors

The webhook must be enabled. Replay adds one attempt under the same svix-id and original event history. It leaves automatic retry scheduling intact and does not start another retry chain.

Use a full-access credential. Unknown or foreign resources return 404. See authentication, errors, rate limits, and pagination.