Callback Events

Read callback trigger events.

Callback Events object

Attributes

object

String

String representing the object's type

id

String

Unique callback event identifier

type

String

Provider event type received by the callback

source_id

String

Provider-specific source identifier for the event

trigger_key

String

Trigger key that produced this event

input

ObjectNullable

Original trigger input payload captured for the event

output

ObjectNullable

Trigger output payload resolved for the event

status

Enum

Lifecycle status for this callback event

error

ObjectNullable

delivery_status

Enum

Aggregate delivery status for this callback event

callback_id

String

Parent callback identifier

callback_instance_id

StringNullable

Callback instance that received the event, when applicable

created_at

Date

Timestamp when the callback event was created

{
  "object": "callback.event",
  "id": "cte_4dEfGhJkLmNpQrSt",
  "type": "message.created",
  "source_id": "thr_123456",
  "trigger_key": "messages.created",
  "input": {},
  "output": {},
  "status": "pending",
  "error": {},
  "delivery_status": "pending",
  "callback_id": "clb_4dEfGhJkLmNpQrSt",
  "callback_instance_id": "cbi_5gHjKlMnPqRsTuVw",
  "created_at": "2025-09-15T10:30:00.000Z"
}

List callback events

Returns a paginated list of callback events.

URL Parameters

callback_id

String

The unique identifier for the callback

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

id

UnionOptional

Filter by callback event ID(s)

type

UnionOptional

Filter by event type(s)

source_id

UnionOptional

Filter by provider source ID(s)

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

Get callback event

Retrieves a specific callback event.

URL Parameters

callback_id

String

The unique identifier for the callback

callback_event_id

String

The unique identifier for the callback_event

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