---
title: "Read one conversation"
method: GET
path: "/inbox/conversations/{channel}/{id}"
tags: ["Inbox"]
---

# Read one conversation

`GET /inbox/conversations/{channel}/{id}`

## Request

- Base URL: `https://warmysender.com/api/v1`
- URL: `https://warmysender.com/api/v1/inbox/conversations/{channel}/{id}`
- Auth: HTTP bearer

One conversation in full: every message in the order it happened, who wrote it, when it was sent and (for chats) when it was delivered, read or edited, plus the internal notes your team left on an email thread. Does not mark the conversation read.

Required scope: `campaigns:read`.

Message bodies are returned as plain text, cut at 20,000 characters each.

## Path parameters

- `channel` 'email' | 'linkedin' | 'instagram' | 'whatsapp', required
- `id` string, required

## Response `200`

Success

## Other responses

- `400`: `validation_error` — channel is not one of the four.
- `401`: `unauthorized` — Missing or invalid API key.
- `403`: `insufficient_scope` — The API key lacks the scope this endpoint requires.
- `404`: `not_found` — No such conversation in your workspace.
- `429`: `rate_limited` — Too many requests — slow down and retry after the Retry-After delay.

---

[API](https://skmtc.dev/warmysender/apis/warmysender-public-api.md) · [All operations](https://skmtc.dev/warmysender/apis/warmysender-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/warmysender/apis/warmysender-public-api/revisions/eb5c7f10a1cd?raw)