Create a meeting
POST {{baseUrl}}/users/:userId/meetings
Use this API to
create a meeting
for a user. For user-level apps, pass
the
me
value
instead of the
userId
parameter.
-
A meeting's
start_url
value is the URL a host or an alternative host can use to start a meeting. The expiration time for thestart_url
value is two hours for all regular users. -
For
custCreate
meeting hosts (users created with thecustCreate
parameter via the Create users API), the expiration time of thestart_url
parameter is 90 days from the generation of thestart_url
.
Note:
For security reasons, the recommended way to programmatically (after expiry) get the updated
start_url
value is to call the
Get a meeting
API. Refer to the
start_url
value in the response.
Scopes:
meeting:write:admin
,
meeting:write
Rate Limit Label
:
Medium
- This API has a daily rate limit of
100 requests per day
. The rate limit is applied against the
userId
of the
meeting host
used to make the request.
Request Body
{"agenda"=>"My Meeting", "default_password"=>false, "duration"=>60, "password"=>"123456", "pre_schedule"=>false, "recurrence"=>{"end_date_time"=>"2022-04-02T15:59:00Z", "end_times"=>7, "monthly_day"=>1, "monthly_week"=>1, "monthly_week_day"=>1, "repeat_interval"=>1, "type"=>1, "weekly_days"=>"1"}, "schedule_for"=>"jchill@example.com", "settings"=>{"additional_data_center_regions"=>["TY"], "allow_multiple_devices"=>true, "alternative_hosts"=>"jchill@example.com;thill@example.com", "alternative_hosts_email_notification"=>true, "approval_type"=>2, "approved_or_denied_countries_or_regions"=>{"approved_list"=>["CX"], "denied_list"=>["CA"], "enable"=>true, "method"=>"approve"}, "audio"=>"telephony", "audio_conference_info"=>"test", "authentication_domains"=>"example.com", "authentication_exception"=>[{"email"=>"jchill@example.com", "name"=>"Jill Chill"}], "authentication_option"=>"signIn_D8cJuqWVQ623CI4Q8yQK0Q", "auto_recording"=>"cloud", "breakout_room"=>{"enable"=>true, "rooms"=>[{"name"=>"room1", "participants"=>["jchill@example.com"]}]}, "calendar_type"=>1, "close_registration"=>false, "contact_email"=>"jchill@example.com", "contact_name"=>"Jill Chill", "email_notification"=>true, "encryption_type"=>"enhanced_encryption", "focus_mode"=>true, "global_dial_in_countries"=>["US"], "host_video"=>true, "jbh_time"=>0, "join_before_host"=>false, "language_interpretation"=>{"enable"=>true, "interpreters"=>[{"email"=>"interpreter@example.com", "languages"=>"US,FR"}]}, "meeting_authentication"=>true, "meeting_invitees"=>[{"email"=>"jchill@example.com"}], "mute_upon_entry"=>false, "participant_video"=>false, "private_meeting"=>false, "registrants_confirmation_email"=>true, "registrants_email_notification"=>true, "registration_type"=>1, "show_share_button"=>true, "use_pmi"=>false, "waiting_room"=>false, "watermark"=>false, "host_save_video_order"=>true, "alternative_host_update_polls"=>true}, "start_time"=>"2022-03-25T07:32:55Z", "template_id"=>"Dv4YdINdTk+Z5RToadh5ug==", "timezone"=>"America/Los_Angeles", "topic"=>"My Meeting", "tracking_fields"=>[{"field"=>"field1", "value"=>"value1"}], "type"=>2}
HEADERS
| Key | Datatype | Required | Description |
| Content-Type
| string | | |
| Accept
| string | | |
RESPONSES
status: Created
{"assistant_id":"kFFvsJc-Q1OSxaJQLvaa_A","host_email":"jchill@example.com","id":92674392836,"registration_url":"https://example.com/meeting/register/7ksAkRCoEpt1Jm0wa-E6lICLur9e7Lde5oW6","agenda":"My Meeting","created_at":"2022-03-25T07:29:29Z","duration":60,"h323_password":"123456","join_url":"https://example.com/j/11111","occurrences":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"password":"123456","pmi":97891943927,"pre_schedule":false,"recurrence":{"type":1,"end_date_time":"2022-04-02T15:59:00Z","end_times":7,"monthly_day":1,"monthly_week":1,"monthly_week_day":1,"repeat_interval":1,"weekly_days":"1"},"settings":{"allow_multiple_devices":true,"alternative_hosts":"jchill@example.com;thill@example.com","alternative_hosts_email_notification":true,"alternative_host_update_polls":true,"approval_type":0,"approved_or_denied_countries_or_regions":{"approved_list":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"denied_list":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"enable":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"method":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"audio":"telephony","authentication_domains":"example.com","authentication_exception":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"authentication_name":"Sign in to Zoom","authentication_option":"signIn_D8cJuqWVQ623CI4Q8yQK0Q","auto_recording":"cloud","breakout_room":{"enable":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"rooms":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"calendar_type":1,"close_registration":false,"cn_meeting":false,"contact_email":"jchill@example.com","contact_name":"Jill Chill","custom_keys":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"email_notification":true,"encryption_type":"enhanced_encryption","enforce_login":true,"enforce_login_domains":"example.com","focus_mode":true,"global_dial_in_countries":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"global_dial_in_numbers":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}],"host_video":true,"in_meeting":false,"jbh_time":0,"join_before_host":true,"language_interpretation":{"enable":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"interpreters":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"meeting_authentication":true,"mute_upon_entry":false,"participant_video":false,"private_meeting":false,"registrants_confirmation_email":true,"registrants_email_notification":true,"registration_type":1,"show_share_button":true,"use_pmi":false,"waiting_room":false,"watermark":false},"start_time":"2022-03-25T07:29:29Z","start_url":"https://example.com/s/11111","timezone":"America/Los_Angeles","topic":"My Meeting","tracking_fields":[{"field":"field1","value":"value1","visible":true},{"field":"field1","value":"value1","visible":true}],"type":2}