Event: failed | Teekrr | API Documentation

Triggered when the provider returns a permanent failure for the recipient. For prepaid clients this also automatically releases the reserved credit for that single recipient back to your available balance.

Emitted for SMS and WhatsApp. As with delivered, the data shape differs per channel. Provider status/error strings are passed through verbatim - treat them as opaque and do not branch on undocumented values.

Triggered when the provider returns a permanent failure for the recipient. For prepaid clients this also automatically **releases** the reserved credit for that single recipient back to your available balance. Emitted for **SMS** and **WhatsApp**. As with `delivered`, the `data` shape differs per channel. Provider status/error strings are passed through verbatim - treat them as opaque and do not branch on undocumented values.

Payload

The payload of this webhook request is an object.

eventenumRequired

channelenumRequired

api_keyobjectRequired

The API key whose broadcast produced this event, so a consumer whose several keys point at one endpoint can tell them apart. null for a dashboard-composed send or an unattributable message.

timestampdatetimeRequired

When Teekrr built the payload (ISO 8601, UTC).

dataobjectRequired

Response

2XX

Acknowledge receipt within 10 seconds.

1	{
2	"event": "failed",
3	"channel": "sms",
4	"api_key": {
5	"uuid": "00000000-0000-0000-0000-0000000000ak",
6	"name": "Production integration"
7	},
8	"timestamp": "2026-05-06T10:16:42.811Z",
9	"data": {
10	"message_id": "MSG-ABC123XYZ",
11	"provider_status": "UNDELIV",
12	"msisdn": "60198765432"
13	}
14	}