Calendly Capabilities
Last updated: October 7, 2024
After this article...
You'll understand the capabilities our Calendly integration provides, and how Lumos interacts with the Calendly API.
View users
The mapping between Calendly user statuses and Lumos user account statuses is below.
Calendly User Status | Lumos Account Status |
active | Active |
deactivated | Suspended |
Calendly API endpoint: https://calendly.stoplight.io/docs/api-docs/eaed2e61a6bc3-list-organization-memberships
https://calendly.stoplight.io/docs/api-docs/ff9832c5a6640-get-user (we call this endpoint for each user. If we receive a failure, we assume the user has been deactivated)
View a user's entitlements
Lumos can retrieve the following user entitlements from Calendly.
Role - Whether the user is a Calendly Workspace User, Admin, or Owner.
Calendly API endpoint: https://calendly.stoplight.io/docs/api-docs/eaed2e61a6bc3-list-organization-memberships (we use the "role" field from the User record)
Deprovision a user
AppStore | Offboarding | Access Reviews | License Management |
N/A | ✅ | ✅ | ✅ |
In Lumos, deprovisioning a Calendly user marks their Account Status as "Suspended".
In Calendly, this removes the user from your organization permanently. Organization owners cannot be deprovisioned.
This action reclaims a license in Calendly.
Calendly API endpoint: https://calendly.stoplight.io/docs/api-docs/269e89d9f559f-remove-user-from-organization