---
title: "POST /messages/conversations"
method: POST
path: "/messages/conversations"
tags: ["ConversationAdministration"]
---

# POST /messages/conversations

`POST /messages/conversations`

Creates a new conversation. This is only for create operation.

## Query parameters

- `api-version` string, required

## Request body

- CreateConversationRequest — Request payload for creating a conversation.
  - `conversation` CommunicationConversation, required — A conversation.
    - `id` string, required — The conversation ID.
    - `topic` string — The conversation topic.
    - `deliveryChannelIds` string[] — List of delivery channel IDs.
    - `outboundDeliveryStrategy` 'internalOnly' | 'allParticipants' — The options of the outbound delivery strategy for messages sent by participants in a conversation.
    - `participants` ConversationParticipant[] — List of participants involved in the conversation.
      - `id` string, required — Participant Identifier.
      - `displayName` string — Participant display name.
      - `kind` 'internal' | 'external', required — The type of a participant in a threaded conversation.
  - `initialMessage` Message — Details of a message.
    - `content` string, required — Content of the message.

## Response `201`

The request has succeeded and a new resource has been created as a result.

- CommunicationConversation — A conversation.
  - `id` string, required — The conversation ID.
  - `topic` string — The conversation topic.
  - `deliveryChannelIds` string[] — List of delivery channel IDs.
  - `outboundDeliveryStrategy` 'internalOnly' | 'allParticipants' — The options of the outbound delivery strategy for messages sent by participants in a conversation.
  - `participants` ConversationParticipant[] — List of participants involved in the conversation.
    - `id` string, required — Participant Identifier.
    - `displayName` string — Participant display name.
    - `kind` 'internal' | 'external', required — The type of a participant in a threaded conversation.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/communication-messages.md) · [All operations](https://skmtc.net/azure/apis/communication-messages/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/communication-messages/versions/ec11c913a0e6/schema)