---
title: "POST /contact/create-participant"
method: POST
path: "/contact/create-participant"
---

# POST /contact/create-participant

`POST /contact/create-participant`

Adds a new participant into an on-going chat contact. For more information, see <a href="https://docs.aws.amazon.com/connect/latest/adminguide/chat-customize-flow.html">Customize chat flow experiences by integrating custom participants</a>.

## Request body

- object
  - `InstanceId` string, required — The identifier of the Amazon Connect instance. You can <a href="https://docs.aws.amazon.com/connect/latest/adminguide/find-instance-arn.html">find the instance ID</a> in the Amazon Resource Name (ARN) of the instance.
  - `ContactId` string, required — The identifier of the contact in this instance of Amazon Connect. Only contacts in the CHAT channel are supported.
  - `ClientToken` string — A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. For more information about idempotency, see <a href="https://aws.amazon.com/builders-library/making-retries-safe-with-idempotent-APIs/">Making retries safe with idempotent APIs</a>.
  - `ParticipantDetails` object, required — The details to add for the participant.
    - `ParticipantRole` 'AGENT' | 'CUSTOMER' | 'SYSTEM' | 'CUSTOM_BOT' — The role of the participant being added.
    - `DisplayName` string — The display name of the participant.

## Response `200`

Success

- CreateParticipantResponse
  - `ParticipantCredentials` object — The token used by the chat participant to call <code>CreateParticipantConnection</code>. The participant token is valid for the lifetime of a chat participant.
    - `ParticipantToken` string — The token used by the chat participant to call <a href="https://docs.aws.amazon.com/connect-participant/latest/APIReference/API_CreateParticipantConnection.html">CreateParticipantConnection</a>. The participant token is valid for the lifetime of a chat participant.
    - `Expiry` string — The expiration of the token. It's specified in ISO 8601 format: yyyy-MM-ddThh:mm:ss.SSSZ. For example, 2019-11-08T02:41:28.172Z.
  - `ParticipantId` string — The identifier for a chat participant. The participantId for a chat participant is the same throughout the chat lifecycle.

## Other responses

- `480` — InvalidRequestException
- `481` — InvalidParameterException
- `482` — ResourceNotFoundException
- `483` — InternalServiceException
- `484` — ServiceQuotaExceededException
- `485` — ThrottlingException

---

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