Zoom

A host can connect their Zoom account, so that bookings with them get a Zoom meeting. coss.com creates the meeting when a booking is confirmed, moves it when the booking is rescheduled, and deletes it when the booking is cancelled. The join link goes to the attendee and the host, and onto the host's calendar event.

Zoom has to approve coss.com's app before hosts outside Cal.com's own Zoom account can connect. Until then, a host elsewhere who tries to connect sees an error from Zoom.

Adding the app

Hosts add the app from the page you give them, not from the Zoom App Marketplace.

1. Open your hosted page from your product. If you've embedded it, it's in your own settings.
2. Under Calendars, choose Connect Zoom.
3. Sign in to Zoom if you're asked, read what coss.com is asking for, and choose Allow.
4. You're back on the page, with Zoom listed as connected.

If you build your own page, ask for a consent URL and open it in a new window:

const { data } = await coss.scheduling.calendars.authorize("doctor_482", {
  provider: "zoom",
});
// Send the host to data?.url.

Using it

Offer Zoom on an event type with a zoom location:

await coss.scheduling.eventTypes.create({
  title: "Consultation",
  duration_minutes: 30,
  locations: [{ type: "zoom" }],
  hosts: [{ host: "doctor_482" }],
});

The link appears on the booking moments after it's confirmed, with a scheduling.booking.location_ready webhook. A booking whose host has no Zoom connected still stands, with no link and a scheduling.booking.calendar_write_failed webhook. Group event types can't use Zoom yet.

In a sandbox, a host with a simulated calendar gets a pretend link, so you can build this without a Zoom account.

What Zoom receives, and what coss.com keeps

Meetings have the title "Appointment" and a time, use a waiting room and aren't recorded automatically. No attendee details are sent to Zoom. coss.com stores the Zoom user ID, access tokens (encrypted) and each meeting's ID and link, and doesn't read other meetings' contents. See the Privacy Policy.

Zoom is the host's own account. If a booking involves health data, check that it's covered by their agreement with Zoom.

Removing the app

A host can remove it in either place:

• On your hosted page: under Calendars, choose Disconnect next to Zoom. This also revokes coss.com's access at Zoom.
• In Zoom: in the Zoom App Marketplace, go to Manage, then Added Apps, and remove coss.com.

Either way, coss.com deletes the tokens it holds, and new bookings no longer get a Zoom link. Meetings already created stay on the host's Zoom account until the host deletes them, and their links keep working.

Support

Write to support@coss.com.