# Mark as read

> Mark a received message as read with POST /v1/messages/{id}/read and optionally show the typing indicator.

`POST /v1/messages/{id}/read` marks a message the contact sent as read. With `typing: true`, it also shows the typing indicator.

## Before you start

- An API key with the `send` permission.
- The `id` (`msg_…`) of the **received** message, which comes in the `message.received` event.

## Mark as read

**cURL**

```bash
curl -X POST https://api.messajo.com/v1/messages/msg_.../read \
  -H "Authorization: Bearer $MESSAJO_API_KEY"
```

With the typing indicator:

```bash
curl -X POST https://api.messajo.com/v1/messages/msg_.../read \
  -H "Authorization: Bearer $MESSAJO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "typing": true }'
```

**TypeScript**

```ts
import { Messajo } from "@messajo/sdk";

const messajo = new Messajo({ apiKey: process.env.MESSAJO_API_KEY! });

await messajo.messages.markRead("msg_...");
```

The SDK method takes no `typing` argument. To show the typing indicator, call the REST API (cURL tab) or send `typing: true` on the next send.

**n8n**

n8n HTTP Request: POST https://api.messajo.com/v1/messages/msg_.../read

```json
{ "typing": true }
```

The response returns the id and the confirmation:

```json
{ "id": "msg_...", "read": true }
```

## Fields

| Field | Description |
|---|---|
| `id` (path) | `msg_…` id of the received message. |
| `typing` (body, optional) | `true` shows the typing indicator. Default `false`. |

## By channel

- **WhatsApp:** the typing indicator always marks the message as read.
- **Instagram:** `typing: true` shows the typing indicator before sending and `POST /v1/messages/{id}/read` marks the conversation as seen.
- **Messenger:** uses the same engine as Instagram, see [Messages](/en/connect/messenger/#messages).

`typing` spends one token from the number's bucket (see [Limits](/en/api/limits/)).

## Common errors

- [`not_found`](/en/errors#not_found) (404): the `id` does not exist.
- [`connection_rate_limited`](/en/errors#connection_rate_limited) (429): no token left in the bucket. Wait for `Retry-After` and retry.
