> ## Documentation Index
> Fetch the complete documentation index at: https://support.rallly.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Zoom
> Connect your Zoom account so Rallly creates the meeting link when you finalize a poll
With the Zoom integration, Rallly creates a Zoom meeting on your account at the moment you finalize a poll. The join link goes into the event, the calendar invite and the confirmation emails, so participants never wait for a link to follow.
Zoom requires a [Pro subscription](https://rallly.co/pricing).
## How it works
1. You connect your Zoom account once, from your settings.
2. When you create a poll, you choose Zoom as the video call. The poll shows "Zoom" to participants while voting is open; there is no link yet.
3. When you finalize the poll, Rallly creates a Zoom meeting for the chosen time on your Zoom account and attaches the join link to the event.
The meeting is created on the Zoom account you connected, so it follows that account's settings, such as waiting rooms, passcodes and recording defaults. Rallly does not change those settings.
## Requirements
* A Zoom account. A free Zoom plan is enough.
* The Zoom integration must be enabled on the Rallly instance you use. On rallly.co it is available to all accounts; on a self-hosted instance the administrator turns it on.
## Adding the app
In Rallly, open **Settings** from the sidebar and choose **Conferencing**.
Next to **Zoom**, click **Connect**. You are sent to Zoom to sign in and approve the connection.
Zoom shows what Rallly is asking for (listed under [Permissions](#permissions)). Click **Allow**. You are returned to Rallly, where the email address of your Zoom account appears next to Zoom.
You can connect one Zoom account per Rallly account. To switch to a different Zoom account, disconnect the current one, then connect the new one.
## Using the integration
### Choosing Zoom for a poll
When creating a poll, click **Add video call** and choose **Zoom**.
The form shows "Zoom" as the video call for this poll.
If your Zoom account is not connected, the form tells you so and links to Conferencing settings.
Participants see "Zoom" on the poll page while voting is open. No meeting exists yet.
### Finalizing the poll
When you finalize the poll and pick the winning time, Rallly:
1. Creates a scheduled Zoom meeting on your account for that date and time, using the poll title as the meeting topic.
2. Attaches the join link to the event.
3. Includes the link in the calendar invite (`.ics`) and in the confirmation emails sent to you and to participants.
The meeting also appears in your Zoom account under **Meetings**, where you can edit or delete it like any other meeting.
If the meeting cannot be created, for example because the Zoom connection has expired, the poll stays open and Rallly shows an error. Reconnect your account in Conferencing settings and finalize again.
### Which account hosts the meeting
The meeting is created on the Zoom account of the poll's organizer. If a space member finalizes a poll organized by someone else, the meeting is still created on the organizer's Zoom account.
## Permissions
When you connect, Rallly asks Zoom for these permissions:
| Permission | Why |
| - | - |
| View your user information (`user:read:user`) | To read your Zoom account id and email, which identify the connection and show which account is connected. |
| Create meetings (`meeting:write:meeting`) | To create the meeting when you finalize a poll. |
Rallly does not read your existing meetings, recordings, contacts or chat, and does not join or record meetings.
## Data Rallly stores
For a connected Zoom account, Rallly stores:
* Your Zoom account id and email address, to identify the connection and show it in your settings.
* The access token and refresh token Zoom issues, encrypted at rest, so Rallly can create meetings on your behalf without asking you to sign in each time.
For each finalized poll, Rallly stores the meeting id, join link and passcode of the meeting it created, as part of the event.
Rallly does not store the content of any meeting.
## Removing the app
### From Rallly
1. Open **Settings**, then **Conferencing**.
2. Next to **Zoom**, click the **More options** button and choose **Disconnect**.
The connection is removed immediately: Rallly deletes the account details and tokens it stored, then asks Zoom to revoke its access. To confirm the access is gone, remove the app from Zoom as described below. Polls that already chose Zoom keep that choice but can no longer be finalized with a Zoom link until an account is connected again. Meetings Rallly already created stay in your Zoom account; delete them from Zoom if you no longer need them.
### From Zoom
You can also remove the app from the Zoom side:
1. Sign in to the [Zoom App Marketplace](https://marketplace.zoom.us/).
2. Click **Manage**, then **Added Apps**.
3. Find **Rallly** and click **Remove**.
Removing the app from Zoom revokes Rallly's access. Zoom tells Rallly, which deletes the connection and the tokens it stored, so the account no longer appears in your settings. On a self-hosted instance, this needs the administrator to set up Zoom's deauthorization notice, which Zoom only sends for apps published on the Marketplace. If the account still appears in your settings, disconnect it in Rallly as well.
## Troubleshooting
**"Zoom is not connected" when creating a poll.** Your Rallly account has no Zoom connection, or it was removed. Connect one in Conferencing settings and choose Zoom again.
**Finalizing fails with a video call error.** The Zoom connection has expired or was revoked on the Zoom side. Disconnect and reconnect the account, then finalize again. The poll is unchanged until finalizing succeeds.
**The meeting was created on the wrong account.** The meeting is always created on the poll organizer's connected Zoom account. Check which account is connected in Conferencing settings.
Still stuck? [Contact support](/contact/support).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.