HomeUser GuidesAPI Reference
Get Started
HomeAPI Reference
Authentication
Branches
Contact Groups
Contacts
Conversations
Error HandlingInvoices
Messages
Orders
Rate LimitingSDKs & Code ExamplesTemplatesTicketsAPI VersioningWABA NumbersWebhooks
User GuideAPI ReferenceMessagesMark Message as Read

Mark Message as Read

Update message status to "read"

Reading time: 1 minute

Mark Message as Read

Update message status to "read".

PUT{{base_url}}/w/messages/{id}

Path Parameters

ParameterTypeRequiredDescription
idintegerYesMessage ID

Query Parameters

ParameterTypeRequiredDescription
phone_number_idstringYesPhone number ID

Request Body (JSON)

ParameterTypeRequiredDescriptionDefault
statusstringYesMessage status: readread

Example Request

Example Requestbash
curl -X PUT "{{base_url}}/w/messages/12345?phone_number_id=123456" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "X-Awal-Signature-256: sha256=abc..." \
-H "X-Timestamp: 1704124800" \
-H "X-Domain: your-workspace" \
-H "X-Client-ID: your-client-id" \
-d '{
  "status": "read"
}'

Benefits: Marking messages as read helps with:

  • Organizing conversations
  • Improving customer experience
  • Tracking processed messages

Related

← Back to Messages
View Guide
View