Create a meeting

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.

The start_url of a meeting is a URL using which a host or an alternative host can start a meeting. The expiration time for the start_url field is two hours for all regular users.

For custCreate meeting hosts( i.e., users created using the custCreate option via the Create Users API), the expiration time of the start_url field is 90 days from the generation of the start_url.

For security reasons, the recommended way to retrieve the updated value for the start_url field programmatically (after expiry) is by calling the Retrieve a Meeting API and referring to the value of the start_url field in the response.

Scopes: meeting:write:admin meeting:write

Rate Limit Label: Medium

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://api.zoom.us/v2/users//meetings'

响应示例

201 - response

{
    "created_at": "2019-09-05T16:54:14Z",
    "duration": 60,
    "host_id": "AbcDefGHi",
    "id": 1100000,
    "join_url": "https://zoom.us/j/1100000",
    "settings": {
        "alternative_hosts": "",
        "approval_type": 2,
        "audio": "both",
        "auto_recording": "local",
        "breakout_room": {
            "enable": false,
            "host_video": false,
            "in_meeting": false,
            "join_before_host": true,
            "mute_upon_entry": false,
            "participant_video": false,
            "registrants_confirmation_email": true,
            "registrants_email_notification": true,
            "rooms": [
                {
                    "name": "room1",
                    "participants": [
                        "james.user01@somemail1234.com",
                        "james.user02@somemail1234.com"
                    ]
                },
                {
                    "name": "room2",
                    "participants": [
                        "james.user03@somemail1234.com"
                    ]
                }
            ],
            "use_pmi": false,
            "waiting_room": false,
            "watermark": false
        },
        "close_registration": false,
        "cn_meeting": false,
        "enforce_login": false,
        "enforce_login_domains": "",
        "global_dial_in_countries": [
            "US"
        ],
        "global_dial_in_numbers": [
            {
                "city": "New York",
                "country": "US",
                "country_name": "US",
                "number": "+1 1000200200",
                "type": "toll"
            },
            {
                "city": "San Jose",
                "country": "US",
                "country_name": "US",
                "number": "+1 6699006833",
                "type": "toll"
            },
            {
                "city": "San Jose",
                "country": "US",
                "country_name": "US",
                "number": "+1 408000000",
                "type": "toll"
            }
        ],
        "start_time": "2019-08-30T22:00:00Z",
        "start_url": "https://zoom.us/s/1100000?iIifQ.wfY2ldlb82SWo3TsR77lBiJjR53TNeFUiKbLyCvZZjw",
        "status": "waiting",
        "timezone": "America/New_York",
        "topic": "API Test",
        "type": 2,
        "uuid": "ng1MzyWNQaObxcf3+Gfm6A=="
    }
}

请求参数

Path 参数

Body 参数multipart/form-data

返回响应

🟢201**HTTP Status Code:** `201` Meeting created.

application/json

Body

🔵300**HTTP Status Code:** `300` Invalid enforce_login_domains, separate multiple domains by semicolon. A maximum of {rateLimitNumber} meetings can be created/updated for a single user in one day.

🟠404**HTTP Status Code:** `404` **Not Found** User not found. **Error Code:** `1001` User {userId} not exist or not belong to this account.

修改于 2024-04-24 09:06:48

List meetings

List Zoom meetings client feedback