Zoom integration documentation

How to connect, use and remove the Zoom integration, and where to get support.

This guide explains the full Scholardemia Zoom integration lifecycle so users can add the app, authorise it with Zoom, generate meeting links, use the integration in product workflows, and remove access cleanly when they no longer need it.

Zoom has not yet approved our Zoom apps for public use. Until it does, only approved test accounts can connect their own Zoom account. Everyone can paste a Zoom meeting link into an event today, and that works without connecting Zoom.

Adding the app

Before you connect Zoom, make sure you have an active Scholardemia account and a Zoom account that is allowed to authorise marketplace apps.

Sign in to Scholardemia.
Open Settings → Connected.
In Calendar Integrations, find Zoom and click Connect.
Scholardemia sends you to the Zoom OAuth authorisation screen at https://zoom.us/oauth/authorize.
Review the requested access and approve the authorisation in Zoom.
Zoom redirects you back to Scholardemia, where the integration is stored against your account and you are returned to the page where you started.

OAuth details

Authentication model: OAuth 2.0 authorization code flow.
The authorisation screen lists the identity, meeting, webinar, registration and recording permissions used by your connection.
Scholardemia first resolves the authenticated Zoom user, then provisions meetings on that user's account.

If anything goes wrong during authorisation, use the troubleshooting guide.

Usage

Once Zoom is connected, Scholardemia can generate and attach Zoom meeting links in supported scheduling flows. Users need a connected Zoom account before they can generate a link.

Calendar scheduling

Create or edit an event in the calendar.
Set the meeting type to Online or Hybrid.
Select Zoom as the provider.
Click Generate to create the Zoom meeting link automatically.
Save the event. The generated join link is stored on the event and shown to attendees where applicable.

Networking and direct meeting requests

Open the meeting scheduler for the attendee you want to meet.
Select an overlapping time slot.
Choose Zoom as the meeting platform.
Send the request. Scholardemia creates the Zoom link and inserts it into the direct message.

Event administration

Open the event administration area.
Go to Integrations.
Under Video conferencing, choose Zoom as the provider.
Click Provision meeting to generate the meeting room for that event.

How the Zoom link is generated

At the Zoom API level, the integration needs user identity plus meeting creation access. Zoom supports meeting creation via the user meetings endpoint. Reviewer-facing example:

POST https://api.zoom.us/v2/users/me/meetings
Authorization: Bearer <zoom_access_token>
Content-Type: application/json

{
  "topic": "Meeting with a collaborator",
  "type": 2,
  "start_time": "2026-03-20T14:00:00.000Z",
  "duration": 30,
  "agenda": "Discuss research collaboration",
  "settings": {
    "join_before_host": true
  }
}

In the live Scholardemia implementation, the app first calls GET https://api.zoom.us/v2/users/me to resolve the authenticated Zoom user, then creates the meeting on that account. The returned join URL is stored as the event or request meeting link.

Scholardemia Companion

The Companion brings the event session tools into the Zoom desktop client. It uses a separate connection from the organiser account that creates the room.

Sign in to Scholardemia and open Connect your Zoom companion.
Choose Connect Zoom companion and authorise the Zoom account you will use in the meeting. Your organisation may require approval.
Join the Zoom room linked to your Scholardemia event. In the Zoom desktop client, open Apps → Scholardemia Companion.
The Companion matches the meeting to its Scholardemia session. Sign in if prompted. Discussion, questions and notes require access to that event.

Inside Zoom, use the Companion for questions, reading, private notes and session information. In webinars, questions can remain read-only until a verified event moderator is present. Polls and event group chat are available on the Scholardemia session page in your browser.

For browser joins to rooms hosted through a personal organiser connection, connect Companion first so you join as your own Zoom user. To host in the browser, link Companion to the same Zoom account that owns the room. If you cannot connect, use Open in Zoom and return to Scholardemia for the event tools.

To disconnect, return to the Companion connection page and choose Disconnect companion. To remove its Zoom authorisation, use Zoom App Marketplace → Manage → Added Apps → Scholardemia Companion → Remove. Disconnecting the organiser integration is a separate action in Settings.

If Zoom does not offer the app to your account, its distribution or your organisation's approval policy may restrict installation. Contact support@scholardemia.com for help.

Removing the app

You can remove the integration from Scholardemia, from Zoom Marketplace, or from both.

Disconnect in Scholardemia

Sign in to Scholardemia.
Open Settings → Connected.
In Calendar Integrations, find Zoom.
Click Disconnect.

Remove from the Zoom Marketplace side

Sign in to Zoom.
Open Zoom App Marketplace.
Go to Manage.
Open Added Apps.
Find Scholardemia.
Click Remove.

What changes after removal

New Zoom meetings can no longer be provisioned from Scholardemia until you reconnect the app.
Existing Zoom meetings already created in your Zoom account are not automatically deleted by Scholardemia.
Existing event records or messages that already contain a meeting link may still display that saved link.
Scheduled sessions that depended on automatic Zoom provisioning or refresh may require manual review after removal.

How data is handled after removal

When you disconnect Zoom from Scholardemia, the app clears the stored Zoom access credentials used to create new meetings. Based on the current app behaviour, meeting metadata that was already written into existing events or messages is not automatically purged, and Zoom-side meetings remain under your Zoom account until you remove them there.

Troubleshooting

If Zoom authorisation fails, retry the connection from Settings → Connected and confirm you approved the app in Zoom.
If the app says Zoom is not connected, reconnect the integration before generating a meeting link.
If meeting generation fails, check that your Zoom account can create meetings and that the proposed times are valid.
If you removed the app on Zoom first, disconnect and reconnect it inside Scholardemia to refresh the stored credentials.

For detailed step-by-step recovery paths, open the dedicated troubleshooting guide.

FAQ

Do I need a Zoom account to use the integration?

Yes. You need a Zoom account that can authorise the Scholardemia app and create meetings.

Can I reconnect the app after removing it?

Yes. Return to Settings → Connected, choose Zoom, and complete the OAuth flow again.

What happens to meetings that were already created?

Existing meetings are not deleted automatically by Scholardemia. If you want them removed, delete them directly in Zoom or update the affected Scholardemia events manually.

Where do users join the session?

Users join through the meeting link generated by Zoom. Scholardemia stores and displays that join link in the relevant event, workflow, or direct message.

Contact support

Email: support@scholardemia.com
Support hours: Monday to Friday, 09:00 to 17:00 UTC
Expected initial response time: within 2 business days

When you contact support, include the Scholardemia account email, the Zoom account email, the action you were trying to perform, any visible error message, and a screenshot if possible.