# Create room **POST /v1/Rooms** Video rooms with one or more participants ## Servers - https://video.twilio.com: https://video.twilio.com () ## Authentication methods - Account sid auth token ## Parameters ### Body: application/x-www-form-urlencoded (object) - **EnableTurn** (boolean) Deprecated, now always considered to be true. - **Type** (string) - **UniqueName** (string) An application-defined string that uniquely identifies the resource. It can be used as a `room_sid` in place of the resource's `sid` in the URL to address the resource, assuming it does not contain any [reserved characters](https://tools.ietf.org/html/rfc3986#section-2.2) that would need to be URL encoded. This value is unique for `in-progress` rooms. SDK clients can use this name to connect to the room. REST API clients can use this name in place of the Room SID to interact with the room as long as the room is `in-progress`. - **StatusCallback** (string(uri)) The URL Twilio should call using the `status_callback_method` to send status information to your application on every room event. See [Status Callbacks](https://www.twilio.com/docs/video/api/status-callbacks) for more info. - **StatusCallbackMethod** (string(http-method)) The HTTP method Twilio should use to call `status_callback`. Can be `POST` or `GET`. - **MaxParticipants** (integer) The maximum number of concurrent Participants allowed in the room. The maximum allowed value is 50. - **RecordParticipantsOnConnect** (boolean) Whether to start recording when Participants connect. - **TranscribeParticipantsOnConnect** (boolean) Whether to start transcriptions when Participants connect. If TranscriptionsConfiguration is not provided, default settings will be used. - **VideoCodecs** (array[string]) An array of the video codecs that are supported when publishing a track in the room. Can be: `VP8` and `H264`. - **MediaRegion** (string) The region for the Room's media server. Can be one of the [available Media Regions](https://www.twilio.com/docs/video/ip-addresses#group-rooms-media-servers). - **RecordingRules** () A collection of Recording Rules that describe how to include or exclude matching tracks for recording - **TranscriptionsConfiguration** (object) A collection of properties that describe transcription behaviour. If TranscribeParticipantsOnConnect is set to true and TranscriptionsConfiguration is not provided, default settings will be used. - **AudioOnly** (boolean) When set to true, indicates that the participants in the room will only publish audio. No video tracks will be allowed. - **MaxParticipantDuration** (integer) The maximum number of seconds a Participant can be connected to the room. The maximum possible value is 86400 seconds (24 hours). The default is 14400 seconds (4 hours). - **EmptyRoomTimeout** (integer) Configures how long (in minutes) a room will remain active after last participant leaves. Valid values range from 1 to 60 minutes (no fractions). - **UnusedRoomTimeout** (integer) Configures how long (in minutes) a room will remain active if no one joins. Valid values range from 1 to 60 minutes (no fractions). - **LargeRoom** (boolean) When set to true, indicated that this is the large room. ## Responses ### 201 Created #### Headers - **Access-Control-Allow-Origin** (string) Specify the origin(s) allowed to access the resource - **Access-Control-Allow-Methods** (string) Specify the HTTP methods allowed when accessing the resource - **Access-Control-Allow-Headers** (string) Specify the headers allowed when accessing the resource - **Access-Control-Allow-Credentials** (boolean) Indicates whether the browser should include credentials - **Access-Control-Expose-Headers** (string) Headers exposed to the client #### Body: application/json (object) - **sid** (string | null) The unique string that Twilio created to identify the Room resource. - **status** (string) - **date_created** (string(date-time) | null) The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - **date_updated** (string(date-time) | null) The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format. - **account_sid** (string | null) The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Room resource. - **enable_turn** (boolean | null) Deprecated, now always considered to be true. - **unique_name** (string | null) An application-defined string that uniquely identifies the resource. It can be used as a `room_sid` in place of the resource's `sid` in the URL to address the resource, assuming it does not contain any [reserved characters](https://tools.ietf.org/html/rfc3986#section-2.2) that would need to be URL encoded. This value is unique for `in-progress` rooms. SDK clients can use this name to connect to the room. REST API clients can use this name in place of the Room SID to interact with the room as long as the room is `in-progress`. - **status_callback** (string(uri) | null) The URL Twilio calls using the `status_callback_method` to send status information to your application on every room event. See [Status Callbacks](https://www.twilio.com/docs/video/api/status-callbacks) for more info. - **status_callback_method** (string(http-method) | null) The HTTP method Twilio uses to call `status_callback`. Can be `POST` or `GET` and defaults to `POST`. - **end_time** (string(date-time) | null) The UTC end time of the room in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#UTC) format. - **duration** (integer | null) The duration of the room in seconds. - **type** (string) - **max_participants** (integer) The maximum number of concurrent Participants allowed in the room. - **max_participant_duration** (integer) The maximum number of seconds a Participant can be connected to the room. The maximum possible value is 86400 seconds (24 hours). The default is 14400 seconds (4 hours). - **max_concurrent_published_tracks** (integer | null) The maximum number of published audio, video, and data tracks all participants combined are allowed to publish in the room at the same time. Check [Programmable Video Limits](https://www.twilio.com/docs/video/programmable-video-limits) for more details. If it is set to 0 it means unconstrained. - **record_participants_on_connect** (boolean | null) Whether to start recording when Participants connect. - **video_codecs** (array[string] | null) An array of the video codecs that are supported when publishing a track in the room. Can be: `VP8` and `H264`. - **media_region** (string | null) The region for the Room's media server. Can be one of the [available Media Regions](https://www.twilio.com/docs/video/ip-addresses#media-servers). - **audio_only** (boolean | null) When set to true, indicates that the participants in the room will only publish audio. No video tracks will be allowed. - **empty_room_timeout** (integer) Specifies how long (in minutes) a room will remain active after last participant leaves. Can be configured when creating a room via REST API. For Ad-Hoc rooms this value cannot be changed. - **unused_room_timeout** (integer) Specifies how long (in minutes) a room will remain active if no one joins. Can be configured when creating a room via REST API. For Ad-Hoc rooms this value cannot be changed. - **large_room** (boolean | null) Indicates if this is a large room. - **url** (string(uri) | null) The absolute URL of the resource. - **links** (object(uri-map) | null) The URLs of related resources. [Powered by Bump.sh](https://bump.sh)