Connect your tools to Notion with the API

Learn what Notion’s API can do and how your team can build integrations to create custom workflows.

We believe that if every business and person can tailor software to their problems, the world will be better at solving its problems. Notion’s mission is to make this a ubiquitous reality.

With the launch of our API, now in public beta, you’ll be able to customize Notion even further — teams and developers can build powerful integrations that connect Notion to the tools and workflows they use every day. This opens up a whole new set of problem-solving capabilities for Notion users.

The current version of the API unlocks an initial set of capabilities, setting the foundation for future additions. While the API will continue to evolve, teams at Zapier, Typeform, and Automate.io are already building integrations you can use to bring information from disparate apps together in Notion.

To start building with the API, visit developers.notion.com

API basics

The API allows developers to connect other software to Notion or automate workflows within Notion through integrations.

For example, sales teams might connect Salesforce to Notion — every time a deal is closed in Salesforce, it’s automatically added to a Notion database so you can manage these accounts cross-functionally on Notion (with teams who aren’t using Salesforce). Or your engineering team might build an integration that connects Jira to Notion, so bug tickets can be pulled into a database where all teams can see what's being worked on.

These integrations take siloed information from different tools and centralizes them in Notion for better, more effective work between teams.

And to make the API as accessible as possible, it is available to all Notion users.

What’s the API do?

The API allows for programmatic interaction with databases, pages, and content within Notion. This is done through a series of endpoints — places where the API is communicating and working with Notion to collect and organize information from other sources (like apps). Your team can build or use pre-built integrations to automate workflows for more efficient work.

Here’s a high-level overview of what the API can do:

  • For databasesdatabases are core to how information is stored in Notion. With the API, you can pull specific database entries, search a list of specific database entries based on properties, and get a list of all entries in a database.

  • For pages & blocksblocks comprise Notion pages, allowing you to customize pages depending on your needs, whether in a team wiki or part of a database. The API enables you to create new pages (in a database or in another page), set page properties, or retrieve page properties based on specific requests. You can even create new blocks in those pages and pull all the blocks from a page.

  • For people in your workspace — for teams of all sizes, seeing admins, members, and guests in your workspace helps foster transparency. With Notion’s API, you can get a list of all workspace users. We recommend taking advantage of SCIM to programmatically create and remove members from your workspace.

Visit our developer hub for a deep dive on how to build and use specific integrations.

Notion’s API in action

Want to see what can be built with Notion’s API? Our partners are already building custom integrations and workflows that bring information from many apps together in Notion. As a reminder, these were built using the public beta API, and they could change as the API evolves.

Zapier’s integration

Zapier automatically moves information between Notion and other applications you use every day. It already supports thousands of other apps, such as Slack, Jira, Salesforce, and more.

Using Zapier, you can create automated workflows that cement Notion as your team’s information hub. For example, you can centralize new sales deals, advertising metrics, or website analytics in Notion with no need for your team to manually copy the information over.

Get started here.

Typeform’s form response integration

Typeform helps anyone build online forms and surveys. Its native integration collects all of your form responses in Notion in real-time, so that you easily share them with your team and turn them into powerful insights.

Explore Typeform’s integration here.

Automate.io’s workflow builder

Automate.io is the world’s easiest workflow automation and integration platform — now bringing the power of workflow automation to Notion. With Automate.io’s integration, your team can connect Notion with 200+ cloud apps. You can automatically sync Jira issues to Notion or send Slack notifications on new items in Notion, no coding required.

Learn more here.

During this beta period, we want to hear from you. What use cases would you like to unlock? What apps would you like to use in Notion? Let us know.

Share this guide

Something we didn't cover?