Webhook deliveries

2 endpoints, each with examples that open in the console prefilled.

GET/api/v1/webhook-deliverieswebhooks:readTry in console

List webhook deliveries

Inspect signed webhook attempts, receiver responses, retry state, and final outcome.

Query parameters

limit	string
status	string

Filter with status=pending|delivered|failed, event, or webhook_id.
The payload and receiver response are included for debugging; protect this scope as customer data access.
Use next_cursor exactly as returned. It is opaque.

curl -X GET "https://app.blueticked.com/api/v1/webhook-deliveries?limit=25&status=failed" \
  -H "Authorization: Bearer $BLUETICKED_API_KEY"

Response

{
  "data": [
    {
      "payload": {
        "event": "message.delivered",
        "data": {
          "message_id": "763c4dc3-d46b-4c10-8bd4-3f233a933ea0"
        }
      },
      "next_attempt_at": null,
      "id": "11111111-1111-4111-8111-111111111111",
      "webhook_id": "9a342329-d651-4da0-a2d6-b24e4d3599b5",
      "event": "message.delivered",
      "status": "failed",
      "response_status": 500,
      "response_body": "receiver unavailable",
      "attempt_count": 8,
      "delivered_at": null,
      "failed_permanently_at": "2026-08-04T10:00:00.000Z",
      "created_at": "2026-08-04T09:30:00.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

POST/api/v1/webhook-deliveries/{id}/replaywebhooks:writeTry in console

Replay webhook delivery

Create and queue a fresh attempt for an existing delivery after the receiver has been fixed.

Send Idempotency-Key so a network retry cannot create duplicate replays.
The subscription must still exist and be active.
The replay payload includes replay=true and replay_of=<original delivery id>.
Delivery payloads are kept for 90 days, and removed at once when the contact is erased; replaying such a delivery answers 409 conflict with details.code payload_expired or payload_erased.

curl -X POST "https://app.blueticked.com/api/v1/webhook-deliveries/{id}/replay" \
  -H "Authorization: Bearer $BLUETICKED_API_KEY"

Response

{
  "delivery": {
    "id": "33333333-3333-4333-8333-333333333333",
    "event": "message.delivered",
    "created_at": "2026-08-04T10:15:00.000Z"
  },
  "queued": true,
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}