get_webhook_delivery

One outbound webhook delivery by UUID — its event, status, attempts, the payload that was posted and what the endpoint answered.

Purpose

Read one delivery back, typically the row test_webhook_endpoint returned or one picked out of list_webhook_deliveries, to see whether the worker has posted it yet and what the target said. The row shape is the list's.

Required ability

webhook-delivery:view-any

Input schema

{
  "type": "object",
  "required": ["delivery_id"],
  "properties": {
    "delivery_id": {
      "type": "string",
      "description": "UUID of the webhook delivery to fetch."
    }
  }
}

Output shape

{
  "data": {
    "id": "34f1d78e-05a2-4b69-8c3d-7e921ab06f45",
    "endpoint_id": "c62a08f4-1b7d-4e35-9860-a37f5d21e0b9",
    "event": "subscription.created",
    "event_id": "01HXZ3Q8M7Y2K4N6P9R1T3V5W7",
    "status": "delivered",
    "attempts": 3,
    "response_status": 200,
    "response_excerpt": "{\"ok\":true}",
    "payload": {
      "id": "evt_01HXZ3Q8M7Y2K4N6P9R1T3V5W7",
      "type": "subscription.created",
      "created_at": "2026-09-06T10:05:00+00:00",
      "api_version": "2026-05-01",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "data": { "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4" }
    },
    "next_attempt_at": null,
    "delivered_at": "2026-09-06T10:31:00+00:00",
    "dead_lettered_at": null,
    "created_at": "2026-09-06T10:05:00+00:00"
  }
}

attempts counts every post made so far, so a delivered row with attempts: 3 succeeded on the third try. event_id is the envelope's id without its evt_ prefix — the same value the consumer saw in the SB-Event-Id header, which is how a row here is matched to a line in the consumer's own log.

Example prompts

"Has delivery 34f1d78e-05a2-4b69-8c3d-7e921ab06f45 gone out yet, and what did the endpoint answer?"

"Show me the exact payload our CRM received for that event."

"Why is that delivery still pending?"

Failure modes

RESOURCE_NOT_FOUND — unknown delivery_id, or a delivery to another team's endpoint.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks webhook-delivery:view-any.

list_webhook_deliveries — find the row.
retry_webhook_delivery — replay it if it failed.
Webhook deliveries API — the REST equivalent.