> ## Documentation Index
> Fetch the complete documentation index at: https://whatsapp-docs.kap.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Mark message as read

# Mark messages as read

Updated: Nov 3, 2025

When you get a **messages** webhook indicating an [incoming message](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api), you can use the `message.id` value to mark the message as read.

![](https://scontent-lax7-1.xx.fbcdn.net/v/t39.2365-6/491643461_603380552708521_8284248965365504291_n.png?_nc_cat=105\&ccb=1-7&_nc_sid=e280be&_nc_ohc=KEoQqn2etowQ7kNvwE_7yzz&_nc_oc=AdnJrCg2K2nMaq3lSKml6ycpQrn1FzvnBSv1KfPhb0z4gbQ_q84gkO48ncXXHMog9F8&_nc_zt=14&_nc_ht=scontent-lax7-1.xx&_nc_gid=ldbjmYFyHOeXQNBuUwCv0A\&oh=00_AfkcVNIBpN09WwU92jjYTGLSu2QaaCgekYg2xL4JRghyqg\&oe=695513F0)

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](https://developers.facebook.com/documentation/business-messaging/whatsapp/reference/whatsapp-business-phone-number/message-api) 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                                                                                                                                                                                                                                    |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `&lt;ACCESS_TOKEN&gt;`<br />*String*                      | **Required.**<br />[System token](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#system-user-access-tokens) or [business token](https://developers.facebook.com/documentation/business-messaging/whatsapp/access-tokens#business-integration-system-user-access-tokens). | `EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD` |
| `&lt;API_VERSION&gt;`<br />*String*                       | **Optional.**<br />Graph API version.                                                                                                                                                                                                                                                                             | v24.0                                                                                                                                                                                                                                            |
| `&lt;WHATSAPP_BUSINESS_PHONE_NUMBER_ID&gt;`<br />*String* | **Required.**<br />WhatsApp business phone number ID.                                                                                                                                                                                                                                                             | `106540352242922`                                                                                                                                                                                                                                |
| `&lt;WHATSAPP_MESSAGE_ID&gt;`<br />*String*               | **Required.**<br />WhatsApp message ID. This ID is assigned to the `messages.id` property in **received message** [messages](https://developers.facebook.com/documentation/business-messaging/whatsapp/webhooks/reference/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](https://static.xx.fbcdn.net/rsrc.php/yR/r/OEXJ0_DJeZv.svg)

![Thumbs down icon](https://static.xx.fbcdn.net/rsrc.php/yb/r/qKPgNVNeatU.svg)

ON THIS PAGE

Request syntax

Request parameters

Response

Example request

Example response

***