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 🏗️
Visit our developer hub for documentation, resources, and integration management tools.
Create an internal integration
In your left sidebar, navigate to
Settings & Membersand then theIntegrationstab.Only workspace admins will be able to access the
Integrationstab and create integrations. If you are not an admin, please contact your workspace admin or use a different workspace.Click the
Develop your own integrationslink at the bottom.My integrations will open in your default browser. Click the
+ New integrationbutton.
Note: Make sure you're logged into Notion on your web session with the same account that you used on desktop. Otherwise, you will not see the correct account and workspaces!
Provide a
Namefor your integration. Optionally, you can also upload an image to use as aLogo.Use the dropdown menu to specify which
Associated workspaceyou would like to use this integration with.
Note: Internal integrations are workspace-specific, so to change the associated workspace, you'll have to create a new integration.
Your internal integration has been added successfully! You'll now be able to see it in your workspace, in the
Settings & Membersmenu →My integrations.
Click the
•••next to the internal integration to retrieve the internal integration token. You'll need this token for any API-based automations or workflows your team creates, or to link your workspace to some partner platforms.
Create a public integration
All newly added integrations are internal initially. If you're a developer working on a public integration, first use the above instructions to create an internal integration.
Then, follow the instructions in our developer guide to convert it to a public integration.
