# CreateMeetingWithAttendees
<a name="API_meeting-chime_CreateMeetingWithAttendees"></a>

 Creates a new Amazon Chime SDK meeting in the specified media Region, with attendees. For more information about specifying media Regions, see [Available Regions](https://docs.aws.amazon.com/chime-sdk/latest/dg/sdk-available-regions) and [Using meeting Regions](https://docs.aws.amazon.com/chime-sdk/latest/dg/chime-sdk-meetings-regions.html), both in the *Amazon Chime SDK Developer Guide*. For more information about the Amazon Chime SDK, see [Using the Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/dg/meetings-sdk.html) in the *Amazon Chime SDK Developer Guide*. 

**Note**  
If you use this API in conjuction with the [AudioFeatures](API_meeting-chime_AudioFeatures.md) and [VideoFeatures](API_meeting-chime_VideoFeatures.md) APIs, and you don't specify the `MeetingFeatures.Content.MaxResolution` or `MeetingFeatures.Video.MaxResolution` parameters, the following defaults are used:  
Content.MaxResolution: FHD
Video.MaxResolution: HD

## Request Syntax
<a name="API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax"></a>

```
POST /meetings?operation=create-attendees HTTP/1.1
Content-type: application/json

{
   "Attendees": [ 
      { 
         "Capabilities": { 
            "Audio": "string",
            "Content": "string",
            "Video": "string"
         },
         "ExternalUserId": "string"
      }
   ],
   "ClientRequestToken": "string",
   "ExternalMeetingId": "string",
   "MediaPlacementNetworkType": "string",
   "MediaRegion": "string",
   "MeetingFeatures": { 
      "Attendee": { 
         "MaxCount": number
      },
      "Audio": { 
         "EchoReduction": "string"
      },
      "Content": { 
         "MaxResolution": "string"
      },
      "Video": { 
         "MaxResolution": "string"
      }
   },
   "MeetingHostId": "string",
   "NotificationsConfiguration": { 
      "LambdaFunctionArn": "string",
      "SnsTopicArn": "string",
      "SqsQueueArn": "string"
   },
   "PrimaryMeetingId": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "TenantIds": [ "string" ]
}
```

## URI Request Parameters
<a name="API_meeting-chime_CreateMeetingWithAttendees_RequestParameters"></a>

The request does not use any URI parameters.

## Request Body
<a name="API_meeting-chime_CreateMeetingWithAttendees_RequestBody"></a>

The request accepts the following data in JSON format.

 ** [Attendees](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-Attendees"></a>
The attendee information, including attendees' IDs and join tokens.  
Type: Array of [CreateAttendeeRequestItem](API_meeting-chime_CreateAttendeeRequestItem.md) objects  
Array Members: Minimum number of 1 item. Maximum number of 20 items.  
Required: Yes

 ** [ClientRequestToken](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-ClientRequestToken"></a>
The unique identifier for the client request. Use a different token for different meetings.  
Type: String  
Length Constraints: Minimum length of 2. Maximum length of 64.  
Pattern: `[-_a-zA-Z0-9]*`   
Required: Yes

 ** [ExternalMeetingId](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-ExternalMeetingId"></a>
The external meeting ID.  
Pattern: `[-_&@+=,(){}\[\]\/«».:|'"#a-zA-Z0-9À-ÿ\s]*`   
Values that begin with `aws:` are reserved. You can't configure a value that uses this prefix. Case insensitive.  
Type: String  
Length Constraints: Minimum length of 2. Maximum length of 64.  
Required: Yes

 ** [MediaPlacementNetworkType](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-MediaPlacementNetworkType"></a>
The type of network for the media placement. Either IPv4 only or dual-stack (IPv4 and IPv6).  
Type: String  
Valid Values: `Ipv4Only | DualStack`   
Required: No

 ** [MediaRegion](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-MediaRegion"></a>
The Region in which to create the meeting.  
 Available values: `af-south-1`, `ap-northeast-1`, `ap-northeast-2`, `ap-south-1`, `ap-southeast-1`, `ap-southeast-2`, `ca-central-1`, `eu-central-1`, `eu-north-1`, `eu-south-1`, `eu-west-1`, `eu-west-2`, `eu-west-3`, `sa-east-1`, `us-east-1`, `us-east-2`, `us-west-1`, `us-west-2`.   
Available values in AWS GovCloud (US) Regions: `us-gov-east-1`, `us-gov-west-1`.  
Type: String  
Length Constraints: Minimum length of 2. Maximum length of 64.  
Required: Yes

 ** [MeetingFeatures](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-MeetingFeatures"></a>
Lists the audio and video features enabled for a meeting, such as echo reduction.  
Type: [MeetingFeaturesConfiguration](API_meeting-chime_MeetingFeaturesConfiguration.md) object  
Required: No

 ** [MeetingHostId](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-MeetingHostId"></a>
Reserved.  
Type: String  
Length Constraints: Minimum length of 2. Maximum length of 64.  
Required: No

 ** [NotificationsConfiguration](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-NotificationsConfiguration"></a>
The configuration for resource targets to receive notifications when meeting and attendee events occur.  
Type: [NotificationsConfiguration](API_meeting-chime_NotificationsConfiguration.md) object  
Required: No

 ** [PrimaryMeetingId](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-PrimaryMeetingId"></a>
When specified, replicates the media from the primary meeting to the new meeting.  
Type: String  
Length Constraints: Minimum length of 2. Maximum length of 64.  
Required: No

 ** [Tags](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-Tags"></a>
The tags in the request.  
Type: Array of [Tag](API_meeting-chime_Tag.md) objects  
Array Members: Minimum number of 0 items. Maximum number of 50 items.  
Required: No

 ** [TenantIds](#API_meeting-chime_CreateMeetingWithAttendees_RequestSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-request-TenantIds"></a>
A consistent and opaque identifier, created and maintained by the builder to represent a segment of their users.  
Type: Array of strings  
Array Members: Minimum number of 1 item. Maximum number of 5 items.  
Length Constraints: Minimum length of 2. Maximum length of 256.  
Pattern: `^(?!.*?(.)\1{3})[-_!@#$a-zA-Z0-9]*$`   
Required: No

## Response Syntax
<a name="API_meeting-chime_CreateMeetingWithAttendees_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Attendees": [ 
      { 
         "AttendeeId": "string",
         "Capabilities": { 
            "Audio": "string",
            "Content": "string",
            "Video": "string"
         },
         "ExternalUserId": "string",
         "JoinToken": "string"
      }
   ],
   "Errors": [ 
      { 
         "ErrorCode": "string",
         "ErrorMessage": "string",
         "ExternalUserId": "string"
      }
   ],
   "Meeting": { 
      "ExternalMeetingId": "string",
      "MediaPlacement": { 
         "AudioFallbackUrl": "string",
         "AudioHostUrl": "string",
         "EventIngestionUrl": "string",
         "ScreenDataUrl": "string",
         "ScreenSharingUrl": "string",
         "ScreenViewingUrl": "string",
         "SignalingUrl": "string",
         "TurnControlUrl": "string"
      },
      "MediaRegion": "string",
      "MeetingArn": "string",
      "MeetingFeatures": { 
         "Attendee": { 
            "MaxCount": number
         },
         "Audio": { 
            "EchoReduction": "string"
         },
         "Content": { 
            "MaxResolution": "string"
         },
         "Video": { 
            "MaxResolution": "string"
         }
      },
      "MeetingHostId": "string",
      "MeetingId": "string",
      "PrimaryMeetingId": "string",
      "TenantIds": [ "string" ]
   }
}
```

## Response Elements
<a name="API_meeting-chime_CreateMeetingWithAttendees_ResponseElements"></a>

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

 ** [Attendees](#API_meeting-chime_CreateMeetingWithAttendees_ResponseSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-response-Attendees"></a>
The attendee information, including attendees' IDs and join tokens.  
Type: Array of [Attendee](API_meeting-chime_Attendee.md) objects

 ** [Errors](#API_meeting-chime_CreateMeetingWithAttendees_ResponseSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-response-Errors"></a>
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.  
Type: Array of [CreateAttendeeError](API_meeting-chime_CreateAttendeeError.md) objects

 ** [Meeting](#API_meeting-chime_CreateMeetingWithAttendees_ResponseSyntax) **   <a name="chimesdk-meeting-chime_CreateMeetingWithAttendees-response-Meeting"></a>
The meeting information, including the meeting ID and `MediaPlacement`.  
Type: [Meeting](API_meeting-chime_Meeting.md) object

## Errors
<a name="API_meeting-chime_CreateMeetingWithAttendees_Errors"></a>

For information about the errors that are common to all actions, see [Common Errors](CommonErrors.md).

 ** BadRequestException **   
The input parameters don't match the service's restrictions.    
 ** RequestId **   
The request id associated with the call responsible for the exception.
HTTP Status Code: 400

 ** ConflictException **   
Multiple instances of the same request have been made simultaneously.    
 ** RequestId **   
The ID of the request involved in the conflict.
HTTP Status Code: 409

 ** ForbiddenException **   
The client is permanently forbidden from making the request.    
 ** RequestId **   
The request id associated with the call responsible for the exception.
HTTP Status Code: 403

 ** LimitExceededException **   
The request exceeds the resource limit.    
 ** RequestId **   
The request id associated with the call responsible for the exception.
HTTP Status Code: 400

 ** ServiceFailureException **   
The service encountered an unexpected error.    
 ** RequestId **   
The ID of the failed request.
HTTP Status Code: 500

 ** ServiceUnavailableException **   
The service is currently unavailable.    
 ** RequestId **   
The request id associated with the call responsible for the exception.  
 ** RetryAfterSeconds **   
The number of seconds the caller should wait before retrying.
HTTP Status Code: 503

 ** ThrottlingException **   
The number of customer requests exceeds the request rate limit.    
 ** RequestId **   
The ID of the request that exceeded the throttling limit.
HTTP Status Code: 429

 ** UnauthorizedException **   
The user isn't authorized to request a resource.    
 ** RequestId **   
The request id associated with the call responsible for the exception.
HTTP Status Code: 401

## See Also
<a name="API_meeting-chime_CreateMeetingWithAttendees_SeeAlso"></a>

For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS Command Line Interface V2](https://docs.aws.amazon.com/goto/cli2/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/chime-sdk-meetings-2021-07-15/CreateMeetingWithAttendees)