Zoom integration

How to connect and disconnect Zoom, how lesson meetings are managed, and what Mihraby accesses.

What the integration does

A teacher connects their own Zoom account once. When a student's booking is confirmed, Mihraby creates a Zoom meeting in the teacher's account. The join link appears on the confirmed booking as soon as it is ready, and is included in the confirmation email when available. The meeting is updated if the lesson time changes.

After cancellation, Mihraby attempts to delete an individual meeting. A shared group meeting remains while another active booking exists; deletion is attempted when no active bookings remain. Zoom deletion can fail even though the cancellation succeeds. Deletion is not automatically retried; contact support if a cancelled meeting remains in Zoom.

If you see “Link pending”, your paid booking remains confirmed. Failed meeting creation is automatically retried with increasing delays. After 10 failed attempts in total, automatic retries stop. We email the student when a retry makes the link available. Contact support if the link is still pending and your lesson is approaching.

What Mihraby accesses

Mihraby uses meeting management permission (meeting:write:meeting, meeting:update:meeting and meeting:delete:meeting) to create meetings and update or delete only the meetings it created. It uses profile permission (user:read:user) to read the teacher's Zoom user ID and email. Mihraby never accesses recordings, chats, contacts, or other meetings.

Connect Zoom

  1. Open your course meeting settings.
  2. Click Connect Zoom.
  3. Approve Mihraby on Zoom's screen.
  4. Return to the course meeting settings, select Zoom as the meeting platform, and save the meeting settings.

Disconnect Zoom

  • In Mihraby, open Profile (/profile), find the Zoom section, click Disconnect, and confirm with Disconnect Zoom.
  • Or open Zoom Marketplace > Manage > Added Apps > Mihraby > Uninstall.

When you uninstall through Zoom Marketplace, Zoom notifies Mihraby and the stored tokens are deleted. Disconnecting in Mihraby also deletes the stored tokens, but Mihraby can still appear in your Zoom Added Apps until you uninstall it there; after disconnecting, Mihraby can no longer delete meetings it already created.

Privacy

Mihraby stores encrypted access and refresh tokens, their expiry time, your Zoom user ID and email, and the meeting IDs and join links needed for bookings. Read our privacy policy for more information about how Mihraby handles your data.

Privacy Policy

Support

For help with the Zoom integration, email our support team or visit the contact page.