Event: read | Teekrr | API Documentation

Triggered when the recipient opens the message. WhatsApp only, and only when the recipient has read receipts enabled.

X-Teekrr-Event: read, X-Teekrr-Channel: whatsapp.

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

Payload shape for sent / delivered / read / failed on the whatsapp channel.

Response

2XX

Acknowledge receipt within 10 seconds.

1	{
2	"event": "read",
3	"channel": "whatsapp",
4	"timestamp": "2026-05-06T10:17:31.400Z",
5	"data": {
6	"provider_message_id": "9f8e7d6c5b4a32100f1e2d3c",
7	"msisdn": "60123456789",
8	"status": "read",
9	"broadcast_uuid": "00000000-0000-0000-0000-000000000010"
10	}
11	}