Messages

Mark a conversation as read

Changed on

Marks all unread incoming messages in the conversation as read.

For WhatsApp, this also sends read receipts (blue ticks) to the contact, EXCEPT on coexistence accounts (where the WhatsApp Business app on the customer's phone owns read state and we never override it).

For iMessage, this also marks the conversation read with the contact (1:1 conversations only). Best-effort.

For Instagram (Instagram Login and Facebook Login) and Facebook Messenger, this also sends a mark_seen read receipt to the contact, so they see the conversation as seen. Best-effort: a Meta failure never fails the request.

This is the explicit, human-driven counterpart to GET .../messages, which is side-effect-free and does NOT mark anything read. Call this when a user actually views the conversation.

post/v1/inbox/conversations/{conversationId}/read

Request

Path parameters

conversationIdstring required

The conversation ID

Request body

accountIdstring required

Account ID

Response

Conversation marked read

successboolean
markedCountinteger

Number of messages marked read by this call

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • warning

      added the new account enum value to the / response property for the response status