POST/v1/messaging/messages/{messageId}/read

The customer sees blue ticks on their message. With typing_indicator, they also see that you are typing, until you send your next message or for up to 25 seconds.

Authorization

Bearer token

Authorizationrequiredheader

Send your API key as Bearer YOUR_API_KEY.

Permissionwhatsapp.send

A key with whatsapp.full_access can also mark messages as read. WhatsApp must be turned on for your organization.

Path parameters

messageIdrequiredstring

ID of a message a customer sent you, starting with msg_.

Body parameters

application/json

typing_indicatoroptionalboolean

Also show the customer that you are typing. Default false.

The body can be left out.

Response

application/json200 OK

Example identifiers below are illustrative.

Errors

StatuscodeReturned when
400noneThe body has an unknown field, or typing_indicator isn't a boolean.
401noneThe API key is missing, malformed, revoked, or expired.
403noneThe key lacks the whatsapp.send permission.
403FEATURE_NOT_AVAILABLEWhatsApp is not turned on for your organization.
404message_not_foundNo received message with this ID exists in the key's project, or it was deleted after 30 days.
422whatsapp_mark_read_failedWhatsApp refused to mark the message as read; message includes WhatsApp's reason when it gave one.
422whatsapp_provider_unavailableWhatsApp couldn't be reached. Try again in a few minutes.
Nexiom Connect
Open dashboard