Mark messages as read

Updated: Nov 3, 2025 When you get a messages webhook indicating an incoming message, you can use the message.id value to mark the message as read.

It’s good practice to mark an incoming messages as read within 30 days of receipt. Marking a message as read will also mark earlier messages in the thread as read.

Request syntax

Use the POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages endpoint to mark a message as read.

curl -X POST \
'https://graph.facebook.com/&lt;API_VERSION&gt;/&lt;WHATSAPP_BUSINESS_PHONE_NUMBER_ID&gt;/messages'
-H 'Authorization: Bearer &lt;ACCESS_TOKEN&gt;' \
-H 'Content-Type: application/json' \
-d '
\{
  "messaging_product": "whatsapp",
  "status": "read",
  "message_id": "&lt;WHATSAPP_MESSAGE_ID&gt;"
}'

Request parameters

Placeholder	Description	Example value
`<ACCESS_TOKEN>` String	Required. System token or business token.	`EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD`
`<API_VERSION>` String	Optional. Graph API version.	v24.0
`<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>` String	Required. WhatsApp business phone number ID.	`106540352242922`
`<WHATSAPP_MESSAGE_ID>` String	Required. WhatsApp message ID. This ID is assigned to the `messages.id` property in received message messages webhooks.	`wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJDQjZCMzlEQUE4OTJBMTE4RTUA`

Response

Upon success:

\{
  "success": true
}

Example request

curl 'https://graph.facebook.com/v24.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
\{
  "messaging_product": "whatsapp",
  "status": "read",
  "message_id": "wamid.HBgLMTY1MDM4Nzk0MzkVAgARGBJDQjZCMzlEQUE4OTJBMTE4RTUA"
}'

Example response

\{
  "success": true
}

Did you find this page helpful? Thumbs up icon

ON THIS PAGE Request syntax Request parameters Response Example request Example response

Overview

Getting started

Business setup

Messages

Templates

Embedded signup

Flows

Calling

Groups

Payments

Catalogs

Marketing messages

Click to WhatsApp ads

Solution providers

API reference

Pricing

Policies

Other

Support

Mark message as read

Mark messages as read

Request syntax

Request parameters

Response

Example request

Example response

​Mark messages as read

​Request syntax

​Request parameters

​Response

​Example request

​Example response

Mark messages as read

Request syntax

Request parameters

Response

Example request

Example response