---
title: "POST /messages/conversations/{conversationId}/participants:add"
method: POST
path: "/messages/conversations/{conversationId}/participants:add"
tags: ["ConversationThread"]
---

# POST /messages/conversations/{conversationId}/participants:add

`POST /messages/conversations/{conversationId}/participants:add`

Adds participants to a specific conversation.

## Path parameters

- `conversationId` string, required

## Query parameters

- `api-version` string, required

## Headers

- `Repeatability-Request-ID` string
- `Repeatability-First-Sent` string, date-time
- `x-ms-client-request-id` string, uuid

## Request body

- AddParticipantsOptions — Request payload for adding participants to a conversation.
  - `participants` ConversationParticipant[], required — List of participants to add.
    - `id` string, required — Participant Identifier.
    - `displayName` string — Participant display name.
    - `kind` 'internal' | 'external', required — The type of a participant in a threaded conversation.

## Response `207`

Successful

- AddParticipantsResult — Response for the add participants operation.
  - `invalidParticipants` UpdateParticipantsResult[], required — List of Ids with Errors if failed to be added
    - `id` string, required — Participant User Id.
    - `error` AzureCoreFoundationsError — The error object.
      - `code` string, required — One of a server-defined set of error codes.
      - `message` string, required — A human-readable representation of the error.
      - `target` string — The target of the error.
      - `details` AzureCoreFoundationsError[] — An array of details about specific errors that led to this reported error.
      - `innererror` AzureCoreFoundationsInnerError — An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.
        - `code` string — One of a server-defined set of error codes.
        - `innererror` AzureCoreFoundationsInnerError — recursive

## 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/revisions/ec11c913a0e6/schema)