# Zoom

This document outlines how users can connect Zoom accounts from the Pyas Dashboard.

For documentation on how to connect Zoom accounts through the Pyas REST API, please refer to [this part of our API reference](/rest-api-reference/zoom.md).

In order to make integrating with Zoom easier, end-users and developers can use our Zoom for Pyas app. Below are the steps for adding the Zoom for Pyas app, usage, and removing/revoking the Zoom for Pyas app.

This guide assumes you already have at least one Pyas App created in your Pyas Dashboard. If you don't have any apps created, see this guide on [Creating an App](/fundamentals/getting-set-up/creating-an-app.md).

## Adding the App

* Login to the Pyas dashboard: <https://www.app.pyas.io/auth/login>.
* Click on **Apps** in the left menu bar.
* Click on the app that you want to connect the Zoom account to.
* Under the Accounts tab, click on **+ Add Account**
* In the add account Modal, add a name and the email address for the Zoom account. Then, select Zoom as the provider and then click on **Connect Zoom Account**

<figure><img src="/files/wIXFD3VBgb74m0uCSJyt" alt=""><figcaption></figcaption></figure>

* A new window with the Zoom oauth/consent screen will now be open.
* Optionally, check the box that reads: ***Allow this app to use my shared access permissions***
* Click the **Allow** button.

<figure><img src="/files/Y1vTVTSYtnFQjS67yPJK" alt=""><figcaption></figcaption></figure>

The Zoom account will now be connected and the Zoom for Pyas app is added.

<figure><img src="/files/weRF9D8QTpeUXrb9yfZg" alt=""><figcaption></figcaption></figure>

## Usage

Here, we discuss how Pyas is used once a Zoom account has been connected.

1. **Read/List Meetings.**
   * To list meetings for a Zoom account from the the dashboard, follow these instructions here: [Get Meetings](#get-meetings).
   * To list meetings via the REST API, make a GET request to the following endpoint: `https://api.pyas.io/zoom/meetings` . For more details on using the REST API, visit the documentation here: [API Reference - Get All Meetings](/rest-api-reference/zoom/meetings.md#get-all-meetings).
2. **Create Meetings**
   * To create meetings for a Zoom account from the dashboard, follow these instructions here: [Create Meeting](#create-meeting)
   * To create meetings via the REST API, make a POST request to the following endpoint:  `https://api.pyas.io/zoom/meetings` . For more details on using the REST API, visit the documentation here: [API Reference - Create a Meeting](/rest-api-reference/zoom/meetings.md#create-a-meeting).
3. **Update Meetings**
   * To update a meeting for a Zoom account from the dashboard, follow these instructions: [Update a Meeting](#update-a-meeting).
   * To update meetings via the REST API, make a PATCH request to the following endpoint:  `https://api.pyas.io/zoom/meetings` . For more details on using the REST API, visit the documentation here: [API Reference - Update a Meeting](/rest-api-reference/zoom/meetings.md#update-a-meeting).
4. **Delete Meetings**

   * To delete a meeting for a Zoom account from the dashboard, follow these instructions: [Delete a Meeting](#delete-a-meeting).
   * To delete meetings via the REST API, make a DELETE request to the following endpoint:  `https://api.pyas.io/zoom/meetings` . For more details on using the REST API, visit the documentation here: [API Reference - Delete a Meeting](/rest-api-reference/zoom/meetings.md#delete-a-meeting).

## **Removing the App**

Users reserve the right to remove the Zoom for Pyas app and revoke Pyas's access to their Zoom account at any time.

When you, the user, revoke access to your account, Pyas will no longer be able to access any of your meetings or personal information. The connected/integrated Zoom account will no longer work.&#x20;

In order continue using Pyas after access has been revoked, the user/developer will need to reconnect the account following the steps from the **Adding the App** section above in this document.

To remove the Zoom for Pyas app, end-users can follow these simple steps:

1. Login to your Zoom Account and navigate to the Zoom App Marketplace.
2. Click **Manage** >> **Added Apps** or search for the "Zoom for Pyas" app.
3. Click the "Zoom for Pyas" app.
4. Click **Remove**.

## Testing the Zoom Integration

Before you start testing the integration, make sure you have at least one valid/active API key created with ***Read and Write*** scopes. [Read How to Create an API Key](/rest-api-reference/api-authentication.md)

1. From the Apps page, select the app that has the accounts you would like to test.
2. In the accounts list, click on the "expand" button on an account card to open an Account View modal.

<figure><img src="/files/8SWnFpixQsLsR9ayoeKU" alt=""><figcaption></figcaption></figure>

3. An Account View modal will open, and you'll be able to start testing the account connection.
4. Under **Test Account Connection**, follow the straight forward options to **Get Meetings**, **Create  Meeting**, **Update a Meeting** and **Delete a Meeting**

<figure><img src="/files/2wFbg8DIoQk7Ez0ALFWz" alt=""><figcaption></figcaption></figure>

#### **Get Meetings**

* To get/read a list of Zoom meetings, simply click the Send Request button and if any meetings exist, they will be displayed in the response section on the right.

#### **Create Meeting**

* Fill in the required fields to create a new meeting and then click the **Send Request** button.

<figure><img src="/files/DechBsRELyvrX7GALIVV" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/Bf6QXHrynULJ9iN1zLFf" alt=""><figcaption></figcaption></figure>

#### **Update a Meeting**

* Copy a meeting ID from the Get Meetings tab
* From the **Update a Meeting** tab, paste in the meeting ID you just copied into the **Meeting ID** field
* Fill in the field(s) that you would like to update
* Click **Send Request**

<figure><img src="/files/sIW7Q1Su8bmdz0MOdSRi" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/BUM3QXT6TMOBXhZD9i0l" alt=""><figcaption></figcaption></figure>

#### **Delete a Meeting**

* Copy a meeting ID from the list of meetings returned on the **Get Meetings** tab
* Paste the meeting ID into the Meeting ID field in the Delete Meeting tab
* Click **Send Request**

<figure><img src="/files/0InyquIG7u2E1ajpKypp" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pyas.io/fundamentals/connected-accounts/zoom.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.