Notion python api how to#
Notion python api code#

To test that everything is set up correctly, you can retrieve a list of objects shared with your integration using the search endpoint.

Notion python api code#

You can use the search box if your integration doesn’t pop up at the top of the list.įor the purposes of the sample code below, create one page and add a connection to your integration. This is now done by adding a connection using the “…” menu in the top right (until recently, it was like sharing with another user). This will give the integration access to that page and it’s child pages. Once you’ve gotten a token, you also need to add a connection to your integration from any pages you wish to share. When you want to share your integration with a wider audience, you will need to set up an OAuth flow to obtain permission and access tokens per workspace - that will be covered in a future post. When you are working with an internal integration, you use the token from the Secrets section of your Integration page for all requests. Notion API requests are authenticated using a Bearer Token.

Your integration will be first created as an Internal Integration, which is great for development. You can change most settings later if you want.

You can just give it a name (I used “Example Integration”), make sure you’re using your desired workspace if you have access to more than one, and hit Submit. If you don’t already have a Notion workspace that you have Admin access to, you’ll need to sign up for a Notion account first, then head on over to and hit the New Integration button. The first step to building a Notion integration is creating your integration and getting a token.

Notion python api how to#

The Notion API is a REST API which returns JSON responses if you need a refresher on what that means I suggest checking out How to use REST API with Python. If you want to know more about what a page is in Notion, and some of the other Notion concepts, check out my earlier post on Notion Basics For Developers. If you’re looking for Python examples using the official Notion API, you’ve come to the right place! In this tutorial, we’ll make a Notion integration, connect a page, retrieve the page, create a child page, and finish off with retrieving that page’s contents, all using the Requests library in Python to access the Notion API.