Redeliver an event

POST/v1/events/{id}/redeliver

Sends an event again, with the same webhook-id and body and a fresh timestamp and signature. By default it goes to every enabled endpoint subscribed to the event's type; pass webhook_endpoint_id to send to one. A redelivery is a single attempt with no automatic retries. If it fails, redeliver again.

Permissions: Secret key with webhooks:manage.

Guide

Webhooks

Request headers#

Idempotency-Keystring
Any string up to 255 characters; use a UUID v4. Kept 24 hours per key (or member) and endpoint. Same key and body replays the first response with Idempotent-Replayed: true.
Max Length 255

Path parameters#

idstring (uuid)Required

Request body#

webhook_endpoint_idstring (uuid)
Send to this endpoint only. It must be enabled and subscribed to the event's type.

Response fields#

Returns 202 with list of Delivery

dataarray of Delivery
Show attributesDelivery
- idstring (uuid)
  The delivery attempt's id.
- event_idstring (uuid)
  The event that was sent.
- webhook_endpoint_idstring (uuid)
  Where it was sent.
- attemptinteger
  1 for the first attempt, then counting up through the retries.
  Min 1
- statusstring
  pending, succeeded or failed.
  One of pending, succeeded, failed
- status_codeintegerNullable
  HTTP status your server returned. Null if there was no response.
- response_msintegerNullable
  How long your server took to respond, in milliseconds.
- errorstringNullable
  Why it failed when there was no HTTP status, for example timeout, connection_refused, tls_error or dns_error.
- attempted_atstring (date-time)Nullable
  When the attempt was made.
- next_retry_atstring (date-time)Nullable
  When the next retry is scheduled. Null after a success or when retries have run out.
has_moreboolean
True when another page exists.
next_cursorstringNullable
Pass as cursor to get the next page.

POST/v1/events/{id}/redeliver

1
2
3
4curl -X POST https://api.unplugdining.com/v1/events/7f3a9c2e-4b8d-4e16-a0c5-1d6b8e2f9a47/redeliver \
  -H "Authorization: Bearer $UNPLUG_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "webhook_endpoint_id": "1c7f4a9e-3d2b-4f86-a5e1-8b0d6c3f9e72" }'

1
2
3
4
5
6
7
8
9const response = await fetch("https://api.unplugdining.com/v1/events/7f3a9c2e-4b8d-4e16-a0c5-1d6b8e2f9a47/redeliver", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.UNPLUG_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ webhook_endpoint_id: "1c7f4a9e-3d2b-4f86-a5e1-8b0d6c3f9e72" }),
});
const data = await response.json();

1
2
3
4
5
6
7
8
9
10
11import os
import requests

response = requests.post(
    "https://api.unplugdining.com/v1/events/7f3a9c2e-4b8d-4e16-a0c5-1d6b8e2f9a47/redeliver",
    headers={
        "Authorization": f"Bearer {os.environ['UNPLUG_KEY']}",
    },
    json={"webhook_endpoint_id": "1c7f4a9e-3d2b-4f86-a5e1-8b0d6c3f9e72"},
)
data = response.json()

Response JSON202

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18{
  "data": [
    {
      "id": "c8e3a5f1-2d7b-4f60-9a14-6e0c3b8d2f75",
      "event_id": "7f3a9c2e-4b8d-4e16-a0c5-1d6b8e2f9a47",
      "webhook_endpoint_id": "1c7f4a9e-3d2b-4f86-a5e1-8b0d6c3f9e72",
      "attempt": 3,
      "status": "pending",
      "status_code": null,
      "response_ms": null,
      "error": null,
      "attempted_at": null,
      "next_retry_at": null
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Error descriptions#

404Not found

not_found

No such event or endpoint, or the event is older than 30 days.

400Bad request

invalid_request

The endpoint isn't subscribed to this event type.

409Conflict

invalid_state

The endpoint is disabled. Turn it back on first.

Any endpoint can also return the common errors.

404 Not found

1
2
3
4
5
6
7{
  "type": "https://docs.unplugdining.com/reference/errors#not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "No such event or endpoint, or the event is older than 30 days."
}