# Pin conversation

> Pins a conversation for the caller. Up to 10 conversations can be pinned. Pinning a conversation that is already pinned returns 204 and changes nothing. A…

`PUT /v2/api/conversations/{contact_number}/pin`

<Note>
**Required scope:** `CONVERSATIONS_WRITE`
</Note>

## Behavior

Pins the conversation with `contact_number` on the Allo line `allo_number`, for the caller only. Returns `204` with no body, also when the conversation is already pinned.

Each user can pin up to 10 conversations. Filter pinned conversations with `pinned=true` on [List conversations](/docs/conversations/list-conversations).

## Errors

| Status | Code | When |
|--------|------|------|
| `400` | `INVALID_REQUEST_BODY` | `allo_number` is missing or blank |
| `403` | `ALLO_NUMBER_FORBIDDEN` | The caller cannot access this line |
| `409` | `PIN_LIMIT_REACHED` | The caller already has 10 pinned conversations. Unpin one first |
