---
title: "POST /meetings#operation=create-attendees"
method: POST
path: "/meetings#operation=create-attendees"
---

# POST /meetings#operation=create-attendees

`POST /meetings#operation=create-attendees`

Creates a new Amazon Chime SDK meeting in the specified media Region, with attendees. For more information about specifying media Regions, see <a href="https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html">Amazon Chime SDK Media Regions</a> in the <i>Amazon Chime SDK Developer Guide</i> . For more information about the Amazon Chime SDK, see <a href="https://docs.aws.amazon.com/chime-sdk/latest/dg/meetings-sdk.html">Using the Amazon Chime SDK</a> in the <i>Amazon Chime SDK Developer Guide</i> .

## Query parameters

- `operation` 'create-attendees', required

## Request body

- object
  - `ClientRequestToken` string, password, required — The unique identifier for the client request. Use a different token for different meetings.
  - `ExternalMeetingId` string, password — The external meeting ID.
  - `MeetingHostId` string, password — Reserved.
  - `MediaRegion` string — <p> The Region in which to create the meeting. Default: <code>us-east-1</code> . </p> <p> Available values: <code>af-south-1</code> , <code>ap-northeast-1</code> , <code>ap-northeast-2</code> , <code>ap-south-1</code> , <code>ap-southeast-1</code> , <code>ap-southeast-2</code> , <code>ca-central-1</code> , <code>eu-central-1</code> , <code>eu-north-1</code> , <code>eu-south-1</code> , <code>eu-west-1</code> , <code>eu-west-2</code> , <code>eu-west-3</code> , <code>sa-east-1</code> , <code>us-east-1</code> , <code>us-east-2</code> , <code>us-west-1</code> , <code>us-west-2</code> . </p>
  - `Tags` Tag[] — The tag key-value pairs.
    - `Key` string, password, required — The key of the tag.
    - `Value` string, password, required — The value of the tag.
  - `NotificationsConfiguration` object — The resource target configurations for receiving Amazon Chime SDK meeting and attendee event notifications. The Amazon Chime SDK supports resource targets located in the US East (N. Virginia) AWS Region (<code>us-east-1</code>).
    - `SnsTopicArn` string, password — The SNS topic ARN.
    - `SqsQueueArn` string, password — The SQS queue ARN.
  - `Attendees` CreateAttendeeRequestItem[] — The request containing the attendees to create.
    - `ExternalUserId` string, password, required — The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
    - `Tags` Tag[] — The tag key-value pairs.
      - `Key` string, password, required — The key of the tag.
      - `Value` string, password, required — The value of the tag.

## Response `201`

Success

- CreateMeetingWithAttendeesResponse
  - `Meeting` object — A meeting created using the Amazon Chime SDK.
    - `MeetingId` string — The Amazon Chime SDK meeting ID.
    - `ExternalMeetingId` string, password — The external meeting ID.
    - `MediaPlacement` object — The media placement for the meeting.
      - `AudioHostUrl` string — The audio host URL.
      - `AudioFallbackUrl` string — The audio fallback URL.
      - `ScreenDataUrl` string — The screen data URL.
      - `ScreenSharingUrl` string — The screen sharing URL.
      - `ScreenViewingUrl` string — The screen viewing URL.
      - `SignalingUrl` string — The signaling URL.
      - `TurnControlUrl` string — The turn control URL.
      - `EventIngestionUrl` string — The event ingestion URL to which you send client meeting events.
    - `MediaRegion` string — The Region in which you create the meeting. Available values: <code>af-south-1</code>, <code>ap-northeast-1</code>, <code>ap-northeast-2</code>, <code>ap-south-1</code>, <code>ap-southeast-1</code>, <code>ap-southeast-2</code>, <code>ca-central-1</code>, <code>eu-central-1</code>, <code>eu-north-1</code>, <code>eu-south-1</code>, <code>eu-west-1</code>, <code>eu-west-2</code>, <code>eu-west-3</code>, <code>sa-east-1</code>, <code>us-east-1</code>, <code>us-east-2</code>, <code>us-west-1</code>, <code>us-west-2</code>.
  - `Attendees` Attendee[] — The attendee information, including attendees IDs and join tokens.
    - `ExternalUserId` string, password — The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
    - `AttendeeId` string — The Amazon Chime SDK attendee ID.
    - `JoinToken` string, password — The join token used by the Amazon Chime SDK attendee.
  - `Errors` CreateAttendeeError[] — If the action fails for one or more of the attendees in the request, a list of the attendees is returned, along with error codes and error messages.
    - `ExternalUserId` string, password — The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.
    - `ErrorCode` string — The error code.
    - `ErrorMessage` string — The error message.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — ResourceLimitExceededException
- `483` — ThrottledClientException
- `484` — UnauthorizedClientException
- `485` — ServiceUnavailableException
- `486` — ServiceFailureException

---

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