Skip to main content
Mark a message as read in a chat. This will update the read status and send read receipts to the sender.
This endpoint marks a specific message and all messages before it as read in the conversation.

​
Request

​
message_id
string
required
The unique identifier of the message to mark as read
​
X-Device-Id
string
Device identifier for multi-device support. Required when multiple devices are registered. If only one device is registered, it will be used as the default.
​
phone
string
required
Phone number with country code and WhatsApp suffixExample: [email protected]

​
Response

​
code
string
Response code (e.g., SUCCESS)
​
message
string
Response message describing the result
​
results
object
​
message_id
string
The ID of the message marked as read
​
status
string
Status of the read operation
curl -X POST \
  'https://your-api-domain.com/message/3EB0B430B6F8F1D0E053AC120E0A9E5C/read' \
  -H 'Content-Type: application/json' \
  -H 'X-Device-Id: my-device' \
  -u 'username:password' \
  -d '{
    "phone": "[email protected]"
  }'

{
  "code": "SUCCESS",
  "message": "Success",
  "results": {
    "message_id": "3EB0B430B6F8F1D0E053AC120E0A9E5C",
    "status": "Message marked as read"
  }
}

Build docs developers (and LLMs) love

Get started for freeTalk to us