Webhooks

List Delivery Attempts

Changed on

Returns one row per HTTP attempt made against this subscription's endpoint, newest first, so a failing integration can be diagnosed without asking support. Retries appear as separate rows sharing a source_event_id, numbered by attempt.

error carries the returned status or the transport error's class and message. The response body your endpoint returned is never stored or returned, and neither is the signing secret or the delivered payload.

Scoped to the calling org: a subscription belonging to another org is a 404, and a deleted subscription keeps its history.

Error codes

error.codeHTTPCauseWhat to do
not_found422No subscription with this id exists in the calling org.Check the id; a deleted subscription is never returned.
get/v1/webhooks/subscriptions/{subscription_id}/deliveries

Request

  • Base URL
    https://api.monaco.com
  • URL
    https://api.monaco.com/v1/webhooks/subscriptions/{subscription_id}/deliveries
  • Auth
    none declared

Path parameters

subscription_idstring uuid required

Query parameters

pageinteger

Page number (1-indexed)

page_sizeinteger

Attempts per page

status'succeeded' | 'failed'

Return only attempts with this status

source_event_idstring nullable

Return only attempts that delivered this envelope id

Response

Successful Response

Example response

{
  "data": [
    {
      "source_event_id": "01994f2c-7a10-7b3e-9d21-6f0a5c8e1234",
      "trigger_key": "deal.stage_changed",
      "attempt": 1,
      "status": "failed",
      "response_code": 404,
      "duration_ms": 184,
      "error": "Endpoint returned HTTP 404"
    }
  ],
  "pagination": {
    "page": 1,
    "page_size": 25,
    "total_count": 142,
    "total_pages": 6
  }
}

Changes