Hoppa till innehållet

Menu

Webhooks

More ways to use this page

Replay a delivery

POST/v1/webhooks/{id}/deliveries/{deliveryId}/replay

TypeScript sendora.webhooks.replay(webhookId, deliveryId)

Python sendora.webhooks.replay(webhook_id, delivery_id)

Key sk_… a server key

Queues the event for delivery again, whatever its state, with the same payload and a fresh attempt count.

Parameters

  • idin pathstring (uuid)required

    The webhook id.

  • deliveryIdin pathstring (uuid)required

    The delivery id.

Responses

202One event on its way to the webhook, retried with backoff until delivered or dead.

  • deliveryIdstring (uuid)required
  • event"delivered" | "bounced" | "deferred" | "spam_complaint" | "unsubscribed" | "cap_warning" | "cap_reached" | "inbound"required
  • messageIdstring (uuid) or nullrequired

    Null for an event about usage rather than a message.

  • inboundMessageIdstring (uuid) or nullrequired

    The received message an inbound event is about; null for every other event.

  • status"pending" | "delivered" | "dead"required

    pending is waiting for its next attempt; dead gave up and can be replayed.

  • attemptsintegerrequired
  • nextAttemptAtstring (date-time) or nullrequired

    When the next attempt is due, while pending.

  • lastStatusCodeinteger or nullrequired

    The HTTP status the endpoint last answered.

  • lastErrorstring or nullrequired

    Why the last attempt failed, when it did.

  • deliveredAtstring (date-time) or nullrequired
  • createdAtstring (date-time)required

Example

{
  "deliveryId": "9e8d7c6b-5a4f-4e3d-9c2b-1a0f9e8d7c60",
  "event": "delivered",
  "messageId": "5f432ffd-c005-499b-aa3a-5b8a088ea20e",
  "inboundMessageId": null,
  "status": "pending",
  "attempts": 0,
  "nextAttemptAt": "2026-09-15T12:05:00.000Z",
  "lastStatusCode": 200,
  "lastError": null,
  "deliveredAt": null,
  "createdAt": "2026-09-15T12:00:02.000Z"
}

Errors

Every error answers error, the code, and message, a sentence for a person. A code that adds fields is shown in full below the table.

CodeStatusMeaning
unauthorized401The key is missing, malformed or revoked.
wrong_token_kind403The key is of the other kind: a server key (sk_) where an account key (ak_) is needed, or the reverse. The message names the kind the operation takes.
not_found404No such webhook or delivery of this server.