---
title: "Replay a delivery"
description: "Deliver one event to the endpoint again, as the dashboard's Replay does. `POST /api/v1/webhooks/{id}/deliveries/{delivery}/replay`"
url: https://www.unitpost.com/docs/platform/post-webhooks-id-deliveries-delivery-replay
section: "Platform API reference"
updated: 2026-10-13
---
# Replay a delivery

`POST /api/v1/webhooks/{id}/deliveries/{delivery}/replay`

Deliver one event to the endpoint again, as the dashboard's Replay does. The same event goes out with the same id, so a receiver that dedupes on it treats the replay as the delivery it already has. The webhook must be enabled: re-enable a disabled or suspended one with [Update a webhook endpoint](https://www.unitpost.com/docs/platform/patch-webhooks-id) first. Find deliveries with [List a webhook's deliveries](https://www.unitpost.com/docs/platform/get-webhooks-id-deliveries). Takes no body. Requires the `webhooks:manage` capability.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes | — |
| `delivery` | path | string | yes | The delivery's id (`msg_…`). |

## Response fields (202)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `object` | enum | yes | One of: `webhook_delivery_replay`. |
| `webhook_id` | string | yes | — |
| `delivery_id` | string | yes | — |
| `replayed` | enum | yes | One of: `true`. |

## Responses

| Status | Description |
| --- | --- |
| 202 | Handed back for delivery. |
| 400 | The body isn't JSON. |
| 401 | Missing or invalid API key. |
| 403 | Insufficient scope. |
| 404 | Webhook or delivery not found. |
| 409 | The webhook is disabled or suspended: re-enable it first. |
| 422 | A body key (this operation takes none). |
| 429 | Too many replays this minute (`Retry-After`). |
| 502 | `engine_unavailable`: the delivery service couldn't be reached; nothing was replayed. Retry. |

## Example request

```bash
curl -X POST 'https://www.unitpost.com/api/v1/webhooks/wh_123/deliveries/delivery_123/replay' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'User-Agent: my-app/1.0'
```

## Example response (202)

```json
{
  "object": "webhook_delivery_replay",
  "webhook_id": "webhook_123",
  "delivery_id": "delivery_123",
  "replayed": true
}
```

## Links

- HTML reference (with Node.js, Python, Ruby, PHP, Laravel, Go, Java, Rust, .NET and CLI examples): https://www.unitpost.com/docs/platform/post-webhooks-id-deliveries-delivery-replay
- OpenAPI 3.1 (full schemas): https://www.unitpost.com/api/v1/openapi.json