---
title: "POST /meetings/{MeetingId}/attendees#operation=batch-create"
method: POST
path: "/meetings/{MeetingId}/attendees#operation=batch-create"
---

# POST /meetings/{MeetingId}/attendees#operation=batch-create

`POST /meetings/{MeetingId}/attendees#operation=batch-create`

Creates up to 100 attendees for an active Amazon Chime SDK meeting. 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 Developer Guide</i>.

## Path parameters

- `MeetingId` string, required

## Query parameters

- `operation` 'batch-create', required

## Request body

- object
  - `Attendees` CreateAttendeeRequestItem[], required — The attendee information, including attendees' IDs and join tokens.
    - `ExternalUserId` string, password, required — <p>The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.</p> <p>Pattern: <code>[-_&amp;@+=,(){}\[\]\/«».:|'"#a-zA-Z0-9À-ÿ\s]*</code> </p> <p>Values that begin with <code>aws:</code> are reserved. You can't configure a value that uses this prefix. Case insensitive.</p>
    - `Capabilities` object — A list of one or more capabilities.
      - `Audio` 'SendReceive' | 'Send' | 'Receive' | 'None', required — The audio capability assigned to an attendee.
      - `Video` 'SendReceive' | 'Send' | 'Receive' | 'None', required — The video capability assigned to an attendee.
      - `Content` 'SendReceive' | 'Send' | 'Receive' | 'None', required — The content capability assigned to an attendee.

## Response `200`

Success

- BatchCreateAttendeeResponse
  - `Attendees` Attendee[] — The attendee information, including attendees' IDs and join tokens.
    - `ExternalUserId` string, password — <p>The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.</p> <p>Pattern: <code>[-_&amp;@+=,(){}\[\]\/«».:|'"#a-zA-Z0-9À-ÿ\s]*</code> </p> <p>Values that begin with <code>aws:</code> are reserved. You can't configure a value that uses this prefix. Case insensitive.</p>
    - `AttendeeId` string — The Amazon Chime SDK attendee ID.
    - `JoinToken` string, password — The join token used by the Amazon Chime SDK attendee.
    - `Capabilities` object — <p>The capabilities assigned to an attendee: audio, video, or content.</p> <note> <p>You use the capabilities with a set of values that control what the capabilities can do, such as <code>SendReceive</code> data. For more information about those values, see .</p> </note> <p>When using capabilities, be aware of these corner cases:</p> <ul> <li> <p>If you specify <code>MeetingFeatures:Video:MaxResolution:None</code> when you create a meeting, all API requests that include <code>SendReceive</code>, <code>Send</code>, or <code>Receive</code> for <code>AttendeeCapabilities:Video</code> will be rejected with <code>ValidationError 400</code>.</p> </li> <li> <p>If you specify <code>MeetingFeatures:Content:MaxResolution:None</code> when you create a meeting, all API requests that include <code>SendReceive</code>, <code>Send</code>, or <code>Receive</code> for <code>AttendeeCapabilities:Content</code> will be rejected with <code>ValidationError 400</code>.</p> </li> <li> <p>You can't set <code>content</code> capabilities to <code>SendReceive</code> or <code>Receive</code> unless you also set <code>video</code> capabilities to <code>SendReceive</code> or <code>Receive</code>. If you don't set the <code>video</code> capability to receive, the response will contain an HTTP 400 Bad Request status code. However, you can set your <code>video</code> capability to receive and you set your <code>content</code> capability to not receive.</p> </li> <li> <p>If meeting features is defined as <code>Video:MaxResolution:None</code> but <code>Content:MaxResolution</code> is defined as something other than <code>None</code> and attendee capabilities are not defined in the API request, then the default attendee video capability is set to <code>Receive</code> and attendee content capability is set to <code>SendReceive</code>. This is because content <code>SendReceive</code> requires video to be at least <code>Receive</code>.</p> </li> <li> <p>When you change an <code>audio</code> capability from <code>None</code> or <code>Receive</code> to <code>Send</code> or <code>SendReceive</code> , and if the attendee left their microphone unmuted, audio will flow from the attendee to the other meeting participants.</p> </li> <li> <p>When you change a <code>video</code> or <code>content</code> capability from <code>None</code> or <code>Receive</code> to <code>Send</code> or <code>SendReceive</code> , and if the attendee turned on their video or content streams, remote attendees can receive those streams, but only after media renegotiation between the client and the Amazon Chime back-end server.</p> </li> </ul>
      - `Audio` 'SendReceive' | 'Send' | 'Receive' | 'None', required — The audio capability assigned to an attendee.
      - `Video` 'SendReceive' | 'Send' | 'Receive' | 'None', required — The video capability assigned to an attendee.
      - `Content` 'SendReceive' | 'Send' | 'Receive' | 'None', required — The content capability assigned to an 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 — <p>The Amazon Chime SDK external user ID. An idempotency token. Links the attendee to an identity managed by a builder application.</p> <p>Pattern: <code>[-_&amp;@+=,(){}\[\]\/«».:|'"#a-zA-Z0-9À-ÿ\s]*</code> </p> <p>Values that begin with <code>aws:</code> are reserved. You can't configure a value that uses this prefix. Case insensitive.</p>
    - `ErrorCode` string — The error code.
    - `ErrorMessage` string — The error message.

## Other responses

- `480` — BadRequestException
- `481` — ForbiddenException
- `482` — NotFoundException
- `483` — UnauthorizedException
- `484` — UnprocessableEntityException
- `485` — LimitExceededException
- `486` — ServiceUnavailableException
- `487` — ServiceFailureException
- `488` — ThrottlingException

---

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