---
title: "Compose Conversation"
method: POST
path: "/v2/conversations/"
tags: ["conversations"]
---

# Compose Conversation

`POST /v2/conversations/`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/conversations/`
- Auth: HTTP bearer

Compose and send a brand new conversation.

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- CreateConversationRequest
  - `channel` 'EMAIL' | 'SMS' | 'WHATSAPP' | 'TEAMS', required
  - `body` string, required
  - `subject` string, nullable
  - `to_recipients` object[], nullable
  - `cc_recipients` object[], nullable
  - `bcc_recipients` object[], nullable
  - `attachment_keys` string[], nullable
  - `integration_connection_id` string, nullable
  - `to_phone` string, nullable
  - `from_phone_number_id` string, nullable
  - `media_urls` string[], nullable
  - `twilio_content_sid` string, nullable
  - `twilio_content_variables` object, nullable
  - `teams_target_type` string, nullable
  - `teams_recipient` string, nullable
  - `teams_team_name` string, nullable
  - `teams_channel_name` string, nullable
  - `teams_mentions` object[], nullable
  - `external_reference_load_id` string, nullable
  - `external_reference_carrier_id` string, nullable
  - `carrier_contact_email` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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