---
title: "Start a new conversation in an inbox"
method: POST
path: "/inboxes/{inbox_id}/conversations"
tags: ["Inboxes"]
---

# Start a new conversation in an inbox

`POST /inboxes/{inbox_id}/conversations`

## Request

- Base URL: `https://api.thrivedesk.com/v1`
- URL: `https://api.thrivedesk.com/v1/inboxes/{inbox_id}/conversations`
- Auth: HTTP bearer

Start a new conversation in an inbox.

## Path parameters

- `inbox_id` string, required

## Request body

- InboxConversationCreate
  - `to` string, email, required
  - `status` 'Active' | 'Pending' | 'Closed', required
  - `subject` string, required
  - `message` string, required
  - `cc` string[]
  - `bcc` string[]
  - `agent` string, nullable: ID of the agent to assign.
  - `tags` string[]
  - `is_draft` boolean, nullable
  - `message_id` string, uuid
  - `intended_inbox_address_id` string, uuid, nullable
  - `contact` object, nullable
    - `name` string, nullable
    - `company` string, nullable
    - `job_title` string, nullable
    - `address` string, nullable
    - `website` string, nullable
    - `notes` string, nullable
    - `is_actor` boolean, nullable
  - `custom_fields` object, nullable: Map of custom-field keys to values.

## Response `200`

Success.

- object
  - `message` string

## Other responses

- `401`: Missing or invalid bearer token.
- `403`: Token is valid but does not include a required scope, or the user does not have access to the resource.
- `404`: Resource not found.
- `422`: Request body failed validation.
- `429`: Rate limit exceeded. The `Retry-After` header indicates how long to wait before retrying. See [Pagination and rate limits](/get-started/pagination) for the full rate-limit policy.
- `500`: Unexpected server error.

---

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