{
"id": "0b7e5d2c-1f3a-4e6b-8c9d-7a1b2c3d4e5f",
"event": "channel.connection.failed",
"occurred_at": "2026-10-06T12:04:12+00:00",
"agency_id": 7,
"data": {
"id": "6f0e2c1a-8b7d-4c3e-9a1f-0d2b3c4e5f60",
"workspace_id": "11111111-1111-1111-1111-111111111111",
"platform": "whatsapp",
"status": "failed",
"channel_id": null,
"error_code": "required_permissions_missing",
"state": "cust_8841",
"expires_at": "2026-10-06T12:30:00+00:00"
}
}Channel connection failed
Sent to your endpoint when Channel connection failed occurs (channel.connection.failed).
Signed as X-Dmly-Signature: sha256=<hmac> (HMAC-SHA256 of the raw body with your endpoint’s secret) when the endpoint has one, alongside X-Dmly-Event and X-Dmly-Delivery headers. Return any 2xx to acknowledge; a non-2xx is retried twice more, after roughly 10s then 60s (three attempts in total).
Sent within about a minute of the session ending. data is the connection, as GET /workspaces/{workspace}/channel-connections/{connection} returns it.
WEBHOOK
channel.connection.failed
{
"id": "0b7e5d2c-1f3a-4e6b-8c9d-7a1b2c3d4e5f",
"event": "channel.connection.failed",
"occurred_at": "2026-10-06T12:04:12+00:00",
"agency_id": 7,
"data": {
"id": "6f0e2c1a-8b7d-4c3e-9a1f-0d2b3c4e5f60",
"workspace_id": "11111111-1111-1111-1111-111111111111",
"platform": "whatsapp",
"status": "failed",
"channel_id": null,
"error_code": "required_permissions_missing",
"state": "cust_8841",
"expires_at": "2026-10-06T12:30:00+00:00"
}
}Was this page helpful?