Read comments: required if you wish to sync the Comments stream.Read content: required for all connections.Check the following capabilities based on your use case:

Make sure you have selected the correct workspace from the Associated workspace dropdown menu, and click Submit. Lastly, we added data using the access token we received when a user granted our integration access to their pages and databases.You must be the owner of the Notion workspace to create a new integration associated with it. Create Notion Auth 2.0 authorization flowįinally, we created the OAuth flow for users granting access to their pages and databases. Create a table to shareĬontinued with creating a table to which we would grant access. We started by creating a public Notion integration and saved all the OAuth credentials 2. If we go back to the Notion database we created in step 2, you'll see the input we just made added to the database: post ( '', headers =headers ,data =json. Start by importing all the libraries and creating variables for your API keys that we received in Notion in step 1: In this section, we'll write to code needed to generateġ) a URL that grants your public integration access to chosen databases/pages andĢ) an access token from the code we'll receive in the authorization redirect Create Notion Auth 2.0 authorization flow Let's head to the next section, where we'll create the Notion 2.0 authorization flow for users.ģ. As you might guess - this is a table we'll populate with tweets later as a use case example. Let's create a table with 2 columns, handle and tweet:Ĭhoose text as the type for the column tweet. This step is to create a new database that we'll authorize our public integration to access. Let's move on to create a new database to share with our integration later on. Remember that you'll only be able to reveal the OAuth client secret once, so make sure to save it somewhere for the next step. Make sure to save the OAuth client ID, OAuth client secret, and Authorization URL for the next steps. When you've filled out all the fields, click on Submit: All these fields are required because you're about to create a public integration available to all Notion users. Used to link to your integration’s website or homepage in your integration page and authentication screens.įurther, fill out a tagline and go ahead and add the links to a privacy policy, terms of use, and finally, a support email. But for your production app, you'll need to provide a redirect URL where you can extract the authorization code from your users.Ĭontinue with adding your Company name and your Website or homepage - this website/homepage will be used in your integration page as stated by Notion: It must also be included in the token request.įor learning, this tutorial will copy the authorization code right from the browser URL. It can’t contain URL fragments, relative paths or wildcards, and can’t be a public IP address. The path will be appended with the authorization code for access and must have a protocol. In the Notion OAuth flow, users will be redirected to this path after they have authenticated with Notion. Let's go ahead and add all the required data, starting with Redirect URIs. This will add a new section, OAuth Domain & URIs, which requires you to provide more data about your public integration. Once you have saved the integration, scroll down to Integration type and click on Public integration:

Lastly, click Submit to create the integration: Then choose the capabilities that the integration will have. We'll upgrade the integration to use OAuth later.

Give your integration a name and select the workspace where you want to install this integration. Start creating an integration by logging into your Notion account, going to, and clicking on the + New integration button. Let's start with creating a public Notion integration. Create Notion Auth 2.0 authorization flow 4. With this walk-through, you'll be able to authenticate users, get their access token, and add data to the database they've shared with your public Notion integration. If you're struggling with creating public Notion integrations and getting access to other users' Notion databases, this tutorial is for you.

How to create a public Notion integration