Learn about Notion integrations.
What is a Notion integration?
A Notion integration expands what you can do with Notion. You can use Notion integrations to interact with Notion data programmatically, so that you can connect that data to other tools or automate workflows within Notion.
Notion users install integrations to tailor their Notion experience to meet their needs. As part of the installation process, users must share specific Notion pages and databases with the integration.
You can use the Notion API to build an integration that sends data to and/or from Notion. For example, you can listen for changes to a Notion database to send automated emails, sync Notion with Github issues, or import data from an external source to a Notion database.
Link Preview integrations
With a Link Preview integration, you can share an excerpt of authenticated content in Notion when an authenticated collaborator shares a supported link.
Identity management integrations
Workspaces on Notion’s enterprise plan are granted access to a SCIM API. SSO using SAML can also be configured for enterprise workspaces.
Public vs. private integrations
By default, all integrations start out as internal integrations.
You can set an integration to public from the integration’s settings page.
Internal Notion integrations
An internal integration is tied to a single, specific workspace. Only members within the workspace can use the integration.
An internal integration adds the tools and services that your workspace needs to Notion in a way that's tailored to your people, workflows, and resources.
After an internal integration is added to a workspace, members must give the integration access to the specific pages or databases that they want it to use.
You need Admin level access to a workspace in order to add an internal integration to the workspace.
If you don’t have Admin access to the target workspace, then you can always develop the integration in a personal workspace, and later ask a workspace Admin for help.
Public Notion integrations
Public integrations are built for a broad audience. Any Notion user, in any workspace, can use a public integration. Public integrations follow the OAuth 2.0 protocol to access multiple workspaces.
By default, all integrations start out as internal integrations. You can change an integration from internal to public via the integration’s settings page.
As part of the OAuth flow, you need to add a redirect URI in the public integration’s settings page. After a user authenticates with Notion, they’re pointed to the redirect URI. When they’re redirected, Notion also sends the redirect URI a temporary code as part of the auth flow.
To share pages with public integrations, users either select pages from the page picker interface during OAuth or can share individual pages from the workspace.
Add a template to an integration
When you create a public integration, you can provide a URL to a Notion page that a user can opt to duplicate in their workspace during the OAuth flow.
Updated 11 days ago