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.

4 min read
In this guide
  • API basics
  • What’s the API do?
  • Notion’s API in action
  • Zapier’s integration
  • Typeform’s form response integration

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, 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 API unlocks an initial set of capabilities, setting the foundation for future additions. Teams at Zapier, Typeform, and Automate.io are 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.

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.

Share this guide

Start with a template

Browse over 10,000 templates in our template gallery


Something we didn't cover?

Powered by Fruition