Introduction
Using Zoom APIs
Pagination
Error Definitions
Rate Limits
Testing Zoom APIs
Account Events
App Events
Chat Message Events
Chat Channel Events
Chatbot Events
Meeting Events
Recording Events
User Events
Webinar Events
Zoom Room Events
Data Compliance
post

/users/{userId}/meetings

Create a meeting for a user.
This API has a daily rate limit of 100 requests per day. Therefore, only 100 Create a Meeting API requests are permitted within a 24 hour window for a user.



Scopes: meeting:write:admin meeting:write

Rate Limit Label: Medium

Authorization

oauth2 - authorizationCode

Request Parameters

1 Path Parameter

Request Body

Meeting object.

1 Example
Schema
object

Base object for meeting.

topic
string

Meeting topic.

type
integer

Meeting Type:
1 - Instant meeting.
2 - Scheduled meeting.
3 - Recurring meeting with no fixed time.
8 - Recurring meeting with fixed time.

3 validations
start_time
string

Meeting start time. We support two formats for start_time - local time and GMT.

To set time as GMT the format should be yyyy-MM-ddTHH:mm:ssZ. Example: “2020-03-31T12:02:00Z”

To set time using a specific timezone, use yyyy-MM-ddTHH:mm:ss format and specify the timezone ID in the timezone field OR leave it blank and the timezone set on your Zoom account will be used. You can also set the time as UTC as the timezone field.

The start_time should only be used for scheduled and / or recurring webinars with fixed time.

1 validation
duration
integer

Meeting duration (minutes). Used for scheduled meetings only.

schedule_for
string

If you would like to schedule this meeting for someone else in your account, provide the Zoom user id or email address of the user here.

timezone
string

Time zone to format start_time. For example, “America/Los_Angeles”. For scheduled meetings only. Please reference our time zone list for supported time zones and their formats.

password
string

Password to join the meeting. By default, password may only contain the following characters: [a-z A-Z 0-9 @ - _ *] and can have a maximum of 10 characters.

Note: If the account owner or the admin has configured minimum password requirement settings, the password value provided here must meet those requirements.

If the requirements are enabled, you can view those requirements by calling either the Get User Settings API or the Get Account Settings API.

1 validation
agenda
string

Meeting description.

1 validation
tracking_fields
array[object]

Tracking fields

recurrence
object

Recurrence object. Use this object only for a meeting with type 8 i.e., a recurring meeting with fixed time.

settings
object

Meeting settings.

Responses

HTTP Status Code: 201
Meeting created.

1 Header
1 Example
Schema
object

Meeting object

id
integer

Meeting ID: Unique identifier of the meeting in “long” format(represented as int64 data type in JSON), also known as the meeting number.

1 validation
topic
string

Meeting topic

type
integer

Meeting Type

3 validations
start_time
string

Meeting start date-time in UTC/GMT. Example: “2020-03-31T12:02:00Z”

1 validation
duration
integer

Meeting duration

timezone
string

Timezone to format start_time

created_at
string

The date and time at which this meeting was created.

1 validation
agenda
string

Agenda

start_url
string

URL to start the meeting. This URL should only be used by the host of the meeting and should not be shared with anyone other than the host of the meeting as anyone with this URL will be able to login to the Zoom Client as the host of the meeting.

join_url
string

URL for participants to join the meeting. This URL should only be shared with users that you would like to invite for the meeting.

password
string

Meeting password. Password may only contain the following characters: [a-z A-Z 0-9 @ - _ * !]

If “Require a password when scheduling new meetings” setting has been enabled and locked for the user, the password field will be autogenerated in the response even if it is not provided in the API request.

h323_password
string

H.323/SIP room system password

pmi
integer

Personal Meeting Id. Only used for scheduled meetings and recurring meetings with no fixed time.

1 validation
tracking_fields
array[object]

Tracking fields

occurrences
array[object]

Array of occurrence objects.

settings
object

Meeting settings.

recurrence
object

Recurrence object. Use this object only for a meeting with type 8 i.e., a recurring meeting with fixed time.

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
Path Params
1 path param not set
userId
$$.env
1 variable not set
oauth_access_token