# Sessions

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

Sessions are the fundamental building blocks of the Video SDK. A session connects two or more users to communicate with each other over video and audio, similar to a virtual meeting. Optional features include in-session chat and screen share.

## Join session

To join a session, make the following call on the Zoom Video SDK instance:

```javascript
const doZoomThings = async () => {
    await zoom.joinSession({
        sessionName:
            "name of video session (case insensitive, they are all converted to lowercase)",
        token: "JWT goes here",
        username:
            "name of user as it will appear in the video session to others",
        audioOptions: {
            connect: true,
            mute: false,
        },
        videoOptions: {
            localVideoOn: true,
        },
        videoOptions: {
            localVideoOn: true,
        },
    });
};
```

The following table describes the properties of `joinSession`.

| Name              | Required | Note                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sessionName`     | Yes      | Name and unique identifier of the session. A user will be able to join the session by entering the session name. Should be alphanumeric with a max-length of 150 characters. It can include symbols and the space character. Session names are case insensitive (they are all converted to lowercase). This must match the `tpc` value in the [SDK JWT payload](/docs/video-sdk/auth/#payload). |
| `userName`        | Yes      | Display name of the user shown in the session. If empty, the name is displayed as the string "null". Max 200 characters. Values longer than 200 characters are truncated without error.                                                                                                                                                                                                         |
| `token`           | Yes      | JWT token generated from your SDK credentials. See [Authorize](/docs/sdk/video/auth/) for details.                                                                                                                                                                                                                                                                                              |
| `sessionPassword` | No       | Password for session. If set, the session will be private and can only be joined if the user provides a valid password. If not set, the session will be public for anyone in your account. To join, they must use `sessionName` only. The field has a max-length limit of 10 characters, printable ASCII characters only (ch >= 32 && ch < 127).                                                |
| `audioOptions`    | No       | Configure audio settings.                                                                                                                                                                                                                                                                                                                                                                       |
| `videoOptions`    | No       | Configure video settings.                                                                                                                                                                                                                                                                                                                                                                       |

See [`JoinSessionConfig`](https://marketplacefront.zoom.us/sdk/custom/reactnative/types/native_ZoomVideoSdk.JoinSessionConfig.html) for details.

## User roles and actions

People in a session can hold one of the following roles: host, manager, or participant.

### Host

The user with the host [`role_type`](/docs/video-sdk/auth/#payload) is the host of the session.

A **host** of the session has the following **privileges**.

-   View information of users in the session.
-   Change the display name of a user in the session.
-   Mute or unmute a user's audio.
-   Transfer the host role to someone else in the session.
-   Promote another user to be a manager of the session.
-   Remove participants from the session.
-   Revoke manager privilege from a user.
-   Start a live stream.
-   Prevent other users from sharing their screen (lock screen).
-   End the session.

### Manager

The manager or co-host role can be assigned to a participant by the host to help the host to manage the session participants.

A **manager** of the session is assigned the following subset of the **host privileges**.

-   Remove participants from a session.
-   Change the display name of a user in the session.
-   Mute or unmute a user's audio.
-   Prevent other users from sharing their screen (lock screen).

### Participant

A regular user who joins the session without host or manager permission. A participant has **privileges** to view their own information as well as the information of other users.