Callback Notifications

Read callback notification deliveries.

Callback Notifications object

Attributes

object

String

String representing the object's type

id

String

Unique callback notification identifier. This delivery intent ID should be used to fetch notification details.

status

Enum

Current notification delivery status

error

ObjectNullable

Last known delivery error payload, if any

attempt_count

Number

Number of delivery attempts made for this notification

event

Object

destination

Object

created_at

Date

Timestamp when the notification was created

updated_at

Date

Timestamp when the notification was last updated

last_attempt_at

DateNullable

Timestamp of the most recent delivery attempt

next_attempt_at

DateNullable

Timestamp of the next scheduled retry attempt, if any

{
  "object": "callback.notification",
  "id": "sdi_0mn59k130hP1fPd2zSMT4C",
  "status": "pending",
  "error": {},
  "event": {
    "object": "callback.notification.event",
    "id": "evt_4dEfGhJkLmNpQrSt",
    "type": "message.created",
    "topics": [
      "messages",
      "messages"
    ],
    "status": "pending",
    "request": {
      "headers": [
        {},
        {}
      ]
    },
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  },
  "destination": {
    "object": "callback.notification.destination",
    "id": "dest_4dEfGhJkLmNpQrSt",
    "name": "Primary Webhook Endpoint",
    "description": "Primary production webhook receiver",
    "type": "http_endpoint",
    "event_types": [
      "message.created",
      "message.created"
    ],
    "retry": {
      "type": "linear"
    },
    "webhook": {
      "id": "wh_4dEfGhJkLmNpQrSt",
      "url": "https://api.example.com/webhooks/metorial",
      "method": "POST",
      "created_at": "2025-09-15T10:30:00.000Z"
    },
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  },
  "created_at": "2025-09-15T10:30:00.000Z",
  "updated_at": "2026-01-10T14:45:00.000Z",
  "last_attempt_at": "2026-01-10T14:45:00.000Z",
  "next_attempt_at": "2026-01-10T14:50:00.000Z"
}

List callback notifications

Returns a paginated list of callback notifications.

URL Parameters

callback_id

String

The unique identifier for the callback

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

destination_id

UnionOptional

Filter by callback destination ID(s)

status

UnionOptional

Filter by callback notification delivery status

GEThttp://api.metorial.com/callbacks/:callback_id/notifications
curl -X GET "https://api.metorial.com/callbacks/cal_Rm4Mnheq2bfEPhBhP7SY/notifications" \
  -H "Authorization: Bearer metorial_sk_..."

Get callback notification

Retrieves a specific callback notification.

URL Parameters

callback_id

String

The unique identifier for the callback

callback_notification_id

String

The unique identifier for the callback_notification

GEThttp://api.metorial.com/callbacks/:callback_id/notifications/:callback_notification_id
curl -X GET "https://api.metorial.com/callbacks/cal_Rm4Mnheq2bfEPhBhP7SY/notifications/cal_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."