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 credit_balance.

Common error codes

WhatsApp (META): 131026 (recipient cannot receive), 131047 (24h window), 131051 (unsupported), 133010 (number not registered)
Email (SES): Throttling, MessageRejected
SMS (Elfo): passed through verbatim from the Elfo response

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 `credit_balance`. ## Common error codes - **WhatsApp (META):** `131026` (recipient cannot receive), `131047` (24h window), `131051` (unsupported), `133010` (number not registered) - **Email (SES):** `Throttling`, `MessageRejected` - **SMS (Elfo):** passed through verbatim from the Elfo response

Payload

The payload of this webhook request is an object.

eventenumRequired

Allowed values:

timestampdatetimeRequired

dataobjectRequired

Response

2XX

Acknowledge receipt within 10 seconds.

1	{
2	"event": "failed",
3	"timestamp": "2026-05-06T10:16:42.811Z",
4	"data": {
5	"messageUuid": "00000000-0000-0000-0000-000000000112",
6	"broadcastUuid": "00000000-0000-0000-0000-000000000001",
7	"channel": "whatsapp",
8	"failedAt": "2026-05-06T10:16:42.811Z",
9	"errorMessage": "Message undeliverable: Recipient cannot receive messages right now",
10	"msisdn": "60198765432",
11	"errorCode": "131026"
12	}
13	}