At Calendly, we are excited about changing the way the world schedules. We are a profitable company, offering ample opportunities to accelerate your career. We’re obsessed with providing an elegant, delightful experience for our customers. This shapes how we develop, design, market and support. We work hard, move fast and pitch in across departments—and always make time to celebrate our accomplishments.

Authenticating

Calendly uses HTTP Basic Auth, a developer-friendly delegated access protocol. Quolum has already connected the necessary wires with Calendly. Using a sequence of click-throughs, your organization's administrator allows Quolum to make API calls to Calendly without getting access to passwords.

Step 1: Initiate a connection to Calendly

Click the Connect button from the Connections card. If you are not an admin, you can invite your organization's Calendly admin to make a connection to your Calendly organization account. When you click on the Connect button, the web browser will navigate to the Calendly login page.

23002300

Quolum Catalog: Calendly App

Step 2: Log in to Calendly

Log in to Calendly using your organization's credentials. The exact login mechanism may depend on your Calendly plan, and the sign-in mechanism used. You may have corporate SSO such as Azure AD, GSuite, or Okta along with multi-factor authentication. Sometimes you may need to enter a Personal Access Token, the step by step details of which can be found at Calendly Developer Portal . Once you have successfully logged-in you can find the API Key and API Secret as mentioned below in Step 3.

933933

Calendly Authentication

Step 3: Finding the API Key and API Secret in Calendly

Step 3.1: Click on "Integrations" on the top bar of the page as shown below

28802880

Calendly Homepage

Step 3.2: Click on "API and webhooks" card on the main Canva. If it is not visible by default click on "All Integrations" option on the left nav bar

28802880

Calendly Integrations Page

Step 3.3: Click on "Get a token now" under Personal access tokens card on the main Canva.

28752875

Calendly Personal access tokens page

Step 3.4: A popup will open asking to create a name for this token. Create a memorable name and click on "Create token"

766766

Calendly Personal access tokens popup

Step 3.5: Copy your token and use it to connect your application right away. You won’t be able to access it again.

Step 4: Provide consent to Quolum

The next screen after login into Calendly is the consent screen. On this screen, Calendly confirms whether you authorize Quolum to access your organization's data.

Step 5: Back to Quolum

Once you have granted access to Quolum on Calendly website, Calendly is going to send you back to Quolum's page in Step 1, where you started. The Connect button on the Connections card would now say Reconnect. Reconnect is used to reauthenticate under circumstances where the access has expired.

Under the hood

Using the OAuth protocol, Quolum now has delegated access to your Calendly Workspace. The Quolum server, running on Amazon AWS VPC, will be able to make API calls and retrieve feature-level utilization of projects, stories, and tasks. Later, this data is crunched and available for visualization on the Quolum dashboard.