Add & manage integrations with the API

Interested in building your own powerful workflows and integrations with Notion's API? Visit our developer hub for documentation, resources, and integration management tools.

• In your left sidebar, navigate to Settings & Members and then the Integrations tab.

• Here, you'll see all of the existing integrations installed for this workspace, the admin who added each integration, and the date each integration was added.

• Click the ••• next to an integration to see additional options:

  • Retrieve an API token for that integration (internal integrations only)

  • Visit the integration developer's website or contact their support (public integrations only)

  • Disconnect the integration

If your workspace is using an Enterprise plan, admins will have access to additional settings for managing integrations within the workspace.

• As an admin, navigate to Settings & Members and then the Integrations tab.

• At the top, you'll see the option to Restrict members from installing integrations. Click the dropdown to the right to access two options:

  • Off: all workspace members can install any integration in the workspace

  • From approved list: workspace members can only install integrations pre-approved by an admin

• If the From approved list option is selected, admins will see an additional option to auto-approve integrations that are built by Notion. These include:

  • GitHub

  • Jira

  • Slack

  • Asana

  • Trello

• Click the + Add approved integration button to approve additional integrations for members in your workspace.

• Under the Approved integrations heading, admins will see a full list of integrations that have been approved and installed in the workspace.

• To the right of each integration's name, the name(s) of the users who have installed the integration in the workspace are listed.

• Click the ••• menu to:

  • filter by user

  • revoke specific users' access to an integration

  • disconnect all users

  • remove the integration from the approved list

Notion has partnered directly with several services (such as Zapier, Typeform, and Automate.io). You can add our partners' public integrations to your workspace directly through their sites via OAuth.

• Search for Notion in the partner platform's app menu and add it.

• In the resulting authentication menu, you'll be asked by the partner integration to allow access your workspace. The access levels required by the integration will be specified.

• Integrations are workspace-specific! Click the workspace name at the top right to switch to another workspace if needed. Then, press Select pages.

• Now, you'll see a list of all of the pages in the selected workspace. Choose the pages you would like the integration to be able to access, and then press Allow access.

• Once you've completed the authentication, you'll see this integration in your workspace's Settings & Members menu → Integrations.

• Click the ••• menu next to the integration name to visit the developer's website, contact the developer's support team, or disconnect the integration from your workspace.

Some partner platforms require an internal integration token in order to link to your workspace.

• In this case, first follow these instructions to create a corresponding internal integration for your workspace.

• Once you've created the internal integration, navigate to Settings & Members in your sidebar and then the Integrations tab.

• Click the ••• menu next to the existing internal integration that you'd like to link to a partner platform, and press Copy internal integration token.

• Paste this internal integration token into the corresponding field on the partner platform's set up form. This allows them to link their service to your internal integration.

Integrations built with the API follow a similar permission system to the sharing permissions for Notion users. In order to use an integration in your workspace, you'll need to add it to the specific page where it will be active.

• Navigate to the page in question and click the Share button on top right.

• Click Add people, emails, groups, or integrations.

• In the resulting pop-up, select the integration you would like to add to this page. You'll only see integrations that have been created for and associated with this workspace.

• The integration will now appear in the Share menu for the page.

• If an integration has granular access to your content, the permission level will show as Mixed access. Clicking on Mixed access will show you the exact permissions that the integration has within the page.

• If you want to remove an integration from a page, click the dropdown next to its name and then press Remove.