Fires when the message could not be delivered before its TTL expired.

​
Payload

{
  "id": "evt_xxxxx",
  "event": "message.expired",
  "timestamp": "2026-03-28T10:00:00Z",
  "data": {
    "message_id": "msg_a1b2c3d4",
    "agent_id": "ag_live_xxxx",
    "to": "+4917612345678",
    "status": "expired",
    "expired_at": "2026-03-28T10:00:00Z"
  }
}
​
message_id
string
Outbound message identifier.
​
agent_id
string
RCS agent that sent the message.
​
to
string
Recipient phone number in E.164 format.
​
status
string
Always expired for this event.
​
expired_at
string
ISO 8601 time when expiry was recorded.