Skip to Content
Apex Settlement
Webhooks

Redeliver a webhook event

Required permissioncustomer:webhooks:manage
POST
/v1/webhooks/deliveries/{id}/redeliver

Sends a delivered or failed delivery again, from a first attempt, with the same event id, so a receiver that deduplicates on it acts once. The endpoint must be active.

Requires the customer:webhooks:manage permission. Not available for an End Customer: Apex-End-Customer is refused.

Authorization

ApiKey
headerAuthorizationBearer <API key>

A Customer API key, created by a Customer admin in the Customer panel and shown once: Authorization: Bearer ak_live_… in production, ak_test_… elsewhere. A key holds a subset of its creator's permissions and may be limited to named IP addresses and an expiry date. Keys never manage people, other keys or approval rules, and never approve a Payout.

Path Parameters

id*string

The delivery's id.

Formatuuid

Response Body

OK

application/json
  1. response
attempt*integer

attempt is how many attempts were made.

created_at*string
Formatdate-time
delivered_at*|
Formatdate-time
duration_ms*integer|null
event_id*string
event_type*string
id*string
last_error?string

last_error says why the last attempt failed when no answer came.

next_attempt_at*|

next_attempt_at is when the next attempt is due, only while the delivery is pending.

Formatdate-time
payload*

payload is the exact body sent, the event as the webhook delivers it.

response_body?string

response_body is the start of the endpoint's last answer, at most 2 KB.

response_status*integer|null
state*string
Value in"pending""delivered""failed"
Example Request
curl -X POST 'http://localhost:3480/v1/webhooks/deliveries/497f6eca-6276-4993-bfeb-53cbbbba6f08/redeliver'
Example Response
{  "attempt": 1,  "created_at": "2026-11-12T09:31:05Z",  "delivered_at": "2026-11-12T09:31:06Z",  "duration_ms": 142,  "event_id": "9b2f7c1e-5d4a-5e8b-a3c6-0f1d2e3a4b5c",  "event_type": "payout.updated",  "id": "2c3d4e5f-6a7b-4c8d-9e0f-1a2b3c4d5e6f",  "last_error": "string",  "next_attempt_at": "2019-08-24T14:15:22Z",  "payload": {},  "response_body": "ok",  "response_status": 200,  "state": "delivered"}