Overview

Learn about Notion integrations.

What's 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.

For example, you can build an integration that sends external data to a Notion database, adds an automation widget to a Notion page, or syncs Notion with GitHub issues. With the Notion Link Previews API, you can share an excerpt of authenticated content in Notion when an authenticated collaborator shares a supported link.

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.

1800

You can build Notion integrations that help collaborators expand what they can do with Notion

Integration types

You can build an internal or a public Notion integration.

📘

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.

Integration capabilities

Integration capabilities establish what an integration, whether public or private, can access and do in a Notion workspace. These capabilities enforce which API endpoints an integration can call, and what content, comment, and user-related information it can access.

For detailed information on integration capabilities, refer to the reference documentation.

Next steps

Additional resources