Create integrations with the Notion API

Create integrations with the Notion API - hero
In this Article

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.

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

  • Only workspace admins will be able to access theย Integrationsย tab and create integrations. If you are not an admin, please contact your workspace admin or use a different workspace.

  • Click theย Develop your own integrationsย link at the bottom.

  • My integrations will open in your default browser. Click theย + New integrationย button.

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ย Nameย for your integration. Optionally, you can also upload an image to use as aย Logo.

  • Use the dropdown menu to specify whichย Associated workspaceย you 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 & Membersย menu โ†’ย 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.

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.

During the app setup process, developers will be able to choose the access level required from the user.

  • Content capabilities:

    • Read content only

    • Write content only

    • Insert content

  • User capabilities

    • No user information

    • Read user info (not including user's email address)

    • Read user info (including email)

When users install integrations, this access level will be displayed. It will also show in the Share menu of any pages that the integration that has been added to. Learn more about installing integrations in a workspace โ†’


Give Feedback

Was this resource helpful?


Up Next

Link previews & Synced Databases

Bring your favorite tools into Notion with link previews and Synced Databases, to keep all of your info in one easily accessible hub ๐Ÿ“ฌ