https://www.youtube.com/watch?v=gp2yhkVw0z4&ab_channel=Notion

https://www.notion.so/front-static/external/readme/images/code@2x.png

Start building with the Notion API

Connect Notion pages and databases to the tools you use every day, creating powerful workflows.

Get started →

Building blocks for developers

Aggregate data from many sources into your team’s workspace. Spend less time context switching, and increase visibility across the software and services you rely on.

🎒 API reference

A technical guide to querying, retrieving, and updating pages, databases, blocks, users and more.

Jump to the reference

🖌 Examples

A starting point to see what’s possible with the API, so you can start bringing your own vision to life. Learn more

🤝 Partner with us

Add value for your users by building seamless integrations with Notion, the all-in-one workspace.

Get in touch


Using Notion’s public API to build integrations

Developers can use Notion’s public REST API to interact with Notion workspaces programmatically. Interactions include working with:

All workspace interactions, such as the above, need to be attributed to a Notion user. To accommodate this requirement for interactions made programmatically, Notion allows for API requests to be attributed to a "bot". To define the capabilities of a bot, developers build integrations, which handle authenticating API requests for the bot, defining when requests should be made, and the read/write capabilities of the integration.