To setup your Notion app in Cobalt for OAuth, you will need the following credentials from your Notion Integrations Page:

  • Client ID
  • Client Secret
  • Scopes


  1. Notion account. You can create one here.

Required Settings

  • Mandatory Scopes
  1. Read user information including email address
  2. Insert comments
If you haven’t already created an app in Notion, you’d need to create one.

Creating an app in Notion

To create a Notion app and aquire the above mentioned credentials, please follow the steps mentioned below:

  1. Log in to your Notion Integrations Page.
  2. Click on + New integration button in the left.
Navigating for App setup
  1. Select a workspace, give the app a Name and click on the Submit button.
  2. Navigate to Capabilities in the left menu, select the mandatory scopes and click on Save changes.

Scopes or Permissions for Notion app can be configured only through the Capabilities section of the app in Notion Integrations Page.

Setting up Notion Integration app
  1. Go to your Apps catalog in Cobalt > Search for Notion > Settings > Use your credentials > Callback Url > Copy it.

To get the Client ID and Client Secret in Notion, the app needs to made public.

  1. Navigate to Distribution and Enable to make the integration public. Fill the required information about organization and paste the Callback Url under Redirect URIs in OAuth Domains and URIs section. Click on Submit.
  2. Navigate to Secrets and copy the OAuth client ID and OAuth client secret.
Getting Credentials

Configuring credentials in Cobalt

App settings page lets you configure the authentication settings for an OAuth 2.0 based application. For your customers to provide you authorization to access their data, they would first need to install your application. This page lets you set up your application credentials.

Setting up application client credentials

Cobalt lets you use pre-configured applications to play around. You can do so by selecting Use our credentials. However, if you wish to use your own application, select Use your own credentials. Provide the aquired Client Id and Client secret and save it.

Actions and triggers

Once the above setup is completed, you can create orchestrations of your use-cases using Notion actions and triggers. Following are the set of Notion actions and triggers supported by Cobalt.