Add & manage integrations with the API

In this Article

Our API is currently in public beta! With it, 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.

Manage integrations in your workspace

Note: Only 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.

Once an integration exists in a workspace, all members will be able to add it to pages.

  • 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

Install public integrations from developers

Install directly from a partner platform

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.

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

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

Add integrations to pages

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: Only 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.

Once an integration exists in a workspace, all members will be able to add it to pages.

  • 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 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 🏗️