Connect Notion

≈ 3 min Extension Bearer Token

Before you start

• A Notion workspace where you can create integrations (workspace owners can; members may need an owner).
• The AWFlow browser extension. These steps run in the extension (the web app hands them to it).

Used by

• Notion

Set it up

1. Create the integration. Open notion.so/my-integrations (Settings › Connections › Develop or manage integrations), click New integration, pick your workspace and keep the type Internal.

2. Copy the secret. On the integration’s page, copy the Internal Integration Secret.

3. Save it in AWFlow. Open Credentials and click Add Credential (or + Add Credential in a node’s Credential field), then fill the New Credential form. In the browser side panel the form comes in two steps: tap Notion in the list, then fill the rest.

   12345

   1. 1 Step 1:Pick Notion Under Integration App / Service, pick Notion. There is no Auth Type menu: Notion uses a Bearer Token.
   2. 2 Step 2:Name it For example Notion – team wiki. A Description is optional.
   3. 3 Step 3:Paste the secret Paste the secret into Bearer Token.
   4. 4 Step 4:Check where it is saved Signed in, choose Local (this browser only) or Cloud (synced to your account) under Storage location. Without an account it is saved locally in this browser, as here.
   5. 5 Step 5:Click Create Credential Check: the credential is listed on the Credentials page, ready to pick in nodes.

   Numbered areas in the screenshot: 1. Integration App / Service: Notion; 2. Name; 3. Bearer Token; 4. Where the secret is stored (here, locally in this browser); 5. Create Credential.

4. Share pages with it. In Notion, open each page or database the workflow should use, then ⋯ › Connections › Connect to and pick your integration. Sharing a parent page shares the pages inside it.

Check it's connected — 

In a Notion node, choose Database › Get many: the databases you shared are listed. A missing one isn’t shared yet.

Where your token lives

Where your token lives — 

The credential is stored where you choose when you create it:

• Local (this browser only): encrypted in this browser. The encryption key is kept on the same device, so turn on the local secret vault to lock it with a passphrase only you know.
• Cloud (synced to your account): sent over an encrypted connection and stored encrypted on AWFlow’s server, so it works on your other devices.

When a step runs, your browser sends it only to api.notion.com. AWFlow’s servers never relay the call.

Privacy & your data →

Permissions each operation needs

Capability (integration settings)	Needed for
Read content	Database · Get many, Get schema; Page · Get, Search; Block · Get
Update content	Page · Update, Delete; Block · Update, Delete
Insert content	Page · Create; Block · Create

Set these under Capabilities on the integration’s page. Access is also limited to the pages you shared.

Common issues

• “Could not find database with ID… (object_not_found)”. The page or database isn’t shared with the integration. Use ⋯ › Connections › Connect to.
• “API token is invalid (unauthorized)”. The secret is wrong or the integration was deleted. Copy it again and update the credential.
• “Insufficient permissions for this endpoint”. A capability is off on the integration (for example Insert content). Turn it on.
• The run is blocked in the web app. Notion runs through the browser extension. Install the extension and allow Notion for this workflow when asked, or run the workflow from the extension. See Extension-only integrations in the web app.

Related

Notion node

All connections

Create and manage credentials

Privacy & your data