- Allow users to request access to Calendly, which invites them to your organization
- Remove users from Calendly when their access is revoked or expires
- Review who holds each organization role, who belongs to each group, and who hosts each event type
- Include Calendly access in access reviews
Supported resources
How Calendly access maps to Opal
- Organization roles: Opal syncs the Owner, Admin, and User roles. Granting User invites the person to your organization by email, and revoking it removes them or cancels their pending invitation. Pending invitees appear as User until they accept.
- Groups: each Calendly group appears in Opal with the access levels Member and Admin. Membership is read-only. Manage it in Calendly.
- Event types: each event type appears in Opal with its hosts. Event types are read-only and can’t be requested.
Limitations
- Calendly’s API can’t change a member’s role, so Opal can’t grant Owner or Admin, and can’t revoke them from someone who holds them. Change these roles in Calendly.
- Opal can’t change group membership or event type hosts. Calendly doesn’t offer an API to write either.
- Teams are not synced.
- If your organization manages users with SCIM, Calendly rejects invites and removals from Opal. Opal still syncs users, roles, groups, and event types for review.
Requirements
Before you begin, you must:- Be an Opal Admin
- Be an Owner or Admin of the Calendly organization
- Be on version
1.1259.0or later, if you self-host Opal - Ask the Opal team to enable the Calendly integration for your organization
Configuration steps
1. Create a personal access token
- In Calendly, go to Integrations & apps > API and webhooks, and generate a new personal access token.
- Name the token, for example
Opal, and select the following scopes:
- Copy the token. Calendly shows it once.
2. Create the Calendly app in Opal
In Opal, go to Inventory > + App and select Calendly. Fill in the following fields:
Opal connects to the organization the token belongs to, and checks that it can read users and groups when you save the app.