Add & manage integrations with the API

Add & manage integrations with the API - hero
In this Article

With our API, you can connect other software to Notion, automate actions within your workspace, and access integrations built by our partners 🤖


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

Note: Both members and admins of a workspace will be able to access the Integrations tab in the Settings & Members menu to create and manage integrations for a workspace.

On an Enterprise Plan workspace, this can be restricted to admins only.

  • 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.

Restrict members from installing integrations

  • 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

Auto-approve integrations built by Notion

  • 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

Approved integrations list

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

Note: Before you can approve an integration for the rest of your workspace, you or another admin will have to install it first! Only integrations already installed in the workspace will show up in the + Approved integration dropdown.

Instructions for installing integrations are specified below.

  • 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

Install directly from a partner platform via OAuth

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.

Tip: Want to see some partner integrations in action? Check out this guide →

Install via internal integration token

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.

Note: partner integration troubleshooting

Note: Notion does not support troubleshooting for partner integrations. Please direct any feedback and questions to the respective partner's support team.

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.

Note: Both members and admins of a workspace will be able to access the Integrations tab in the Settings & Members menu to create and manage integrations for a workspace.

On an Enterprise Plan workspace, this can be restricted to admins only.

  • 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.


Give Feedback

Was this resource helpful?


Up Next

Create integrations with the Notion API

With Notion's API, you'll be able to create custom internal integrations. Some of our partners may also require an internal integration token in order to link their platform to your Notion workspace - below, we'll walk you through how to set this up 🏗️

Powered by Fruition