---
title: "POST /meetings"
method: POST
path: "/meetings"
---

# POST /meetings

`POST /meetings`

Creates a new Amazon Chime SDK meeting in the specified media Region with no initial 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> .

## 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.

## Response `201`

Success

- CreateMeetingResponse
  - `Meeting` object — The meeting information, including the meeting ID and <code>MediaPlacement</code> .
    - `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>.

## 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)