# Zoom meetings (https://docs.akollo.com/en/connections/zoom)



Akollo can read the details of meetings that have already ended in your Zoom account: when each meeting started and ended, how long it ran, how many people took part and which host held it. It never creates, changes or deletes a meeting and never touches registrants. Participant names and e-mail addresses are not read.

## What is synced [#what-is-synced]

| Data                                    | Read by Akollo                                            |
| --------------------------------------- | --------------------------------------------------------- |
| Start and end time of ended meetings    | Yes                                                       |
| Duration                                | Yes                                                       |
| Number of participants                  | Yes                                                       |
| Host who held the meeting               | Yes                                                       |
| Meeting topic                           | Only when **Store meeting topics** is on (off by default) |
| Participant names and e-mail addresses  | No                                                        |
| Registrants                             | No                                                        |
| Creating, changing or deleting meetings | Never                                                     |

## What you need [#what-you-need]

* A Zoom account on the Pro plan or higher. The past-meeting report Akollo reads is not available on the free plan.
* A Zoom account administrator who can create an app in the Zoom App Marketplace.

## Create the Zoom app [#create-the-zoom-app]

<Steps>
  <Step>
    ### Start a Server-to-Server OAuth app [#start-a-server-to-server-oauth-app]

    In the Zoom App Marketplace, choose **Develop → Build App** and pick **Server-to-Server OAuth**.
  </Step>

  <Step>
    ### Name the app [#name-the-app]

    Give the app a name, for example "Akollo meeting reader".
  </Step>

  <Step>
    ### Add the scopes [#add-the-scopes]

    Under **Scopes**, add exactly these two:

    * `user:read:list_users:admin`
    * `report:read:list_meetings:admin`
  </Step>

  <Step>
    ### Activate the app [#activate-the-app]

    Activate the app. Note its **Account ID**, **Client ID** and **Client secret**.
  </Step>
</Steps>

Akollo signs in as this app. It does not ask any person to sign in to Zoom.

## Connect it in Akollo [#connect-it-in-akollo]

<Steps>
  <Step>
    ### Store the client secret [#store-the-client-secret]

    Store the client secret in the Akollo vault for the Zoom connection.
  </Step>

  <Step>
    ### Fill in the provider settings [#fill-in-the-provider-settings]

    Open **Integrations → Connections**, open the Zoom connection and fill in **Provider settings**:

    * **Zoom account ID** and **Client ID** from the app.
    * **Vault reference**: the vault id of the client secret.
    * **Store meeting topics**: off by default. Meeting topics can contain customer names, so turn this on only if your policy allows it. When it is off, Akollo never keeps a topic.
    * **Days to read back**: how far back the first read goes, 1 to 30 days (14 when empty).
  </Step>

  <Step>
    ### Save [#save]

    Save the settings. Changing the account ID or the client ID later needs the client secret again.
  </Step>
</Steps>

<Callout type="warn" title="Warning">
  Your administrators must also allow `zoom.us` and `api.zoom.us` in the connector's network settings. Without both, Akollo sends nothing to Zoom.
</Callout>

## How often it reads [#how-often-it-reads]

Akollo checks for newly ended meetings every hour. Each check reads again from one day before the last meeting it saw. A meeting at a day boundary is therefore never missed, and a meeting read twice is not stored twice.

## FAQ [#faq]

<Accordions type="single">
  <Accordion title="Does Akollo work with a free Zoom account?">
    No. The past-meeting report Akollo reads needs a Zoom account on the Pro plan or higher.
  </Accordion>

  <Accordion title="Does anyone have to sign in to Zoom for Akollo?">
    No. Akollo signs in as the Server-to-Server OAuth app and does not ask any person to sign in.
  </Accordion>

  <Accordion title="Does Akollo read who took part in a meeting?">
    No. It reads how many people took part, not their names or e-mail addresses.
  </Accordion>

  <Accordion title="Why are meeting topics not shown?">
    **Store meeting topics** is off by default, because topics can contain customer names. Turn it on only if your policy allows it.
  </Accordion>

  <Accordion title="How far back does the first read go?">
    As far as **Days to read back** says: 1 to 30 days, 14 when the field is empty.
  </Accordion>
</Accordions>

## Related pages [#related-pages]

* [Connected systems](/en/connections)
* [Sync details](/en/connections/sync-details)