# Create a Zoom App

## Create a Zoom OAuth App

1. Create a Zoom account, if you haven't done so already here: <https://zoom.us/signup#/signup>
2. Login to your Zoom account.
3. Go to the [Zoom App Marketplace](https://marketplace.zoom.us/) and click **Develop** in the dropdown menu in the top-right corner of the page.&#x20;
4. Select **Build App**. A new page will appear displaying the available app types.&#x20;
5. Click **Create** in the **OAuth** option to continue.

<figure><img src="https://703485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAOD4a5iAUra2DB1y99h%2Fuploads%2FEfBVRfJrpiHynrrGvey9%2Fzoom-app-marketplace.PNG?alt=media&#x26;token=b85f51da-eb67-49ff-a8c8-abdf3e8c6e55" alt=""><figcaption></figcaption></figure>

<figure><img src="https://703485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAOD4a5iAUra2DB1y99h%2Fuploads%2FxGeeYNGszOyM95W1Hkw8%2Fzoom-app-type-selection.PNG?alt=media&#x26;token=558fc833-45d8-40bf-bd4e-7b5ac9a3a674" alt=""><figcaption></figcaption></figure>

6. Give your Zoom App a Name
7. For App Type, choose **User-managed app**
8. Set the **Would you like to publish this app on Zoom App Marketplace?** toggle to **Yes**
9. Click on **Create**

<figure><img src="https://703485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAOD4a5iAUra2DB1y99h%2Fuploads%2FEJBaXHGBbwOFDx8kt14R%2Fzoom-create-app.PNG?alt=media&#x26;token=5ecf0f01-e808-4c7e-994c-ca639773b8ac" alt=""><figcaption></figcaption></figure>

A new window displaying your new OAuth app will appear.

## App Credentials

When you create your app, Zoom automatically generates the **Client ID** and **Client Secret** for your app. If you had the **Would you like to publish this App on Zoom Marketplace?** toggle set to **Yes,** Zoom generates 2 sets of Client ID and Client Secret. One set is for development and the other set is for production. Use the **development credentials** to build and test your integration. When you're ready to go live, use the **production credentials.**

1. Add a **Redirect URL for OAuth**. The URL should be where you want your users to go after they authenticate against your application. You'll need to do this for both development and production.

<figure><img src="https://703485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAOD4a5iAUra2DB1y99h%2Fuploads%2FyY3DQH5b6KpvFE9V0Knt%2Fzoom-app-credentials.PNG?alt=media&#x26;token=38dd582f-7b06-49a7-939b-75d62a887bdf" alt=""><figcaption></figcaption></figure>

2. Add the following URLs:

   `https://www.app.pyas.io/org/apps/oauth/zoom/callback`

   `https://api.pyas.io/oauth/zoom/callback`&#x20;
3. Add your own redirect URL to the allow list.
4. Click Continue

<figure><img src="https://703485338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzAOD4a5iAUra2DB1y99h%2Fuploads%2FfXYGtxVSIkWLodPMWjXq%2Fzoom-redirects.PNG?alt=media&#x26;token=639f4e94-e1fc-46e2-8623-91d2aa2e589b" alt=""><figcaption></figcaption></figure>

## App Information

1. Add your **App Name**
2. Add a **Short Description** for your app
3. Add a **Long Description** for your app
4. Add your **Company Name**
5. Add **Developer Contact** information

Click Continue once you're done adding all of your app information.

## Feature

If you would like to get webhook notifications from Zoom, turn on the Event Subscriptions toggle and then add a URL for your webhook. This is optional.

## Scopes

Add the following scopes, based on your app type.

**For User Level apps**:

* `meeting:read`
* `meeting:write`
* `user:read`

**For Account Level apps**:

* `meeting:master`
* `meeting:read:admin`
* `meeting:write:admin`
* `user:read`

### Add Your Zoom App's OAuth Client ID and Client Secret to Pyas

1. Login to your Pyas account
2. Select the Pyas App you will be updating
3. Go to the Pyas App's settings tab
4. Click on Authentication
5. Under **Pyas Authentication**, toggle the **Enable Pyas Auth for Zoom Accounts** switch off. Then, click the **Save Pyas Auth Settings** button.
6. Scroll down to the **Native Zoom Authentication** section
7. Copy your Zoom App's Client ID and paste it in the **Zoom Oauth Client ID** field.
8. Copy your Zoom App's Client Secret and paste it in the **Zoom Oauth Client Secret** field.
9. Add your Zoom App's redirect URL to the **Zoom Callback URL** field.
10. Click on **Save Zoom Settings**

**That's it!** You should now be able to use your Zoom App with Pyas to add Zoom conferencing to calendar events.

Note: If your app is a User Level app, you have to publish it to the Zoom App Marketplace. See the full tutorial here on creating a Zoom app and publishing it: <https://marketplace.zoom.us/docs/guides/build/oauth-app/>