Add & manage integrations with the API
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 workspaceFrom 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 onMixed 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
.