Your all-in-one workspace for notes, docs, wikis, projects, and collaboration. Use it on your own, with your team, or as an entire company.

Authenticating

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

Step 1: Initiate a connection to Notion

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

Step 2: Log in to Notion

Log in to Notion using your organization's credentials. The exact login mechanism may depend on your Notion plan, and the sign-in mechanism used. You may have corporate SSO such as Azure AD, GSuite, or Okta along with multi-factor authentication. Once you have successfully logged in, Notion is going to ask you to grant access to Quolum.

Step 3: Provide consent to Quolum

The next screen after login into Notion is the consent screen. On this screen, Notion confirms whether you authorize Quolum to access your organization's data. Please choose the Organization in the top right-hand corner as shown in the previous screen. After that select all the pages from where you want to get an insight. Ideally one should choose all the pages to get all insight. (Note: For Enterprise Customers, you might need to allow connection to Quolum app in settings)

Step 4: Back to Quolum

Once you have granted access to Quolum on Notion's website, Notion 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 Notion Workspace. The Quolum server, running on Amazon AWS VPC, will be able to make API calls and retrieve feature-level utilization. Later, this data is crunched and available for visualization on the Quolum dashboard.