# Create a meeting

<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! -->

When a user creates a meeting you use the [create a meeting](/docs/api/meetings/#tag/meetings/post/users/{userId}/meetings) API endpoint. The path of this request requires the user's `id`. The `id` used in the path will create this meeting for the specified user.

Endpoint: [Create a Meeting](/docs/api/meetings/#tag/meetings/post/users/{userId}/meetings)

Granular Scopes Required: `meeting:write:meeting`, `meeting:write:meeting:admin`

![](/img/create-user.png)

1. When a user creates a meeting you use the [create a meeting](/docs/api/meetings/#tag/meetings/post/users/{userId}/meetings) API endpoint. The path of this request requires the user's `id`. The `id` used in the path will create this meeting for the specified user.
2. The _start_url_, _id_ and _password_ returned should be saved in your DB. You will need these to provide the host the ability to start the meeting.
3. The _join_url \_returned can be saved in your DB to provide participants to join the meeting._

## Sample API Call

CURL request

```shell
curl --location --request POST 'https://api.zoom.us/users/{userid}/meetings' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "duration": 60,
    "password": "123456",
    "settings": {
     "start_time": "2022-03-25T07:32:55Z",
    "timezone": "America/Los_Angeles",
    "topic": "My Meeting",
    "type": 2
  }'
```

Sample response

```json
{
    "Settings": {
        "Approval_type": 1,
        "registration_type": 2,
        "start_time": "2022-03-25T07:32:55Z",
        "timezone": "America/Los_Angeles",
        "topic": "My Meeting",
        "type": 2
    },
    "agenda": "My Meeting",
    "created_at": "2022-03-25T07:29:29Z",
    "duration": 60,
    "h323_password": "123456",
    "host_email": "dGljbw==@isv-domain.com",
    "id": 92674392836,
    "join_url": "https://example.com/j/11111",
    "registration_url": "https://example.com/meeting/register/7ksAkRCoEpt1Jm0wa-E6lICLur9e7Lde5oW6",
    "start_time": "2022-03-25T07:29:29Z",
    "start_url": "https://example.com/s/11111",
    "timezone": "America/Los_Angeles"
}
```
