Notion app
Create pages and add content to Notion from workflows.
Available on all plans.
Admins can install the Notion app.
Once installed, all members can use it.
Attio's Notion app lets you create Notion pages and add content to them automatically from your workflows. This article covers how to connect Notion to Attio and what each workflow block does.
Install Notion app
To set up the Notion app, you must be a workspace admin in Attio and an admin in Notion. Here's how to get started:
In Attio, click your workspace name, select Workspace settings, then go to Apps in the sidebar.
Open the Notion app and click Install.
Connect Notion to Attio
Workflows use a workspace connection, which is shared across your team. Before you can use Notion blocks in a workflow, you need to create a connector in Notion, store its access token in Attio, and add the connector to the specific Notion pages you want to write to.
Create a Notion connector
Click New connection in the Notion developer portal.
Select the Access token authentication method.
Mark the connector as installable in your chosen workspace.
Enable all content capabilities: Read content, Insert content, and Update content. Also enable Read user information, which lets Attio populate People properties when creating database pages.
Store the token in Attio
Click your workspace name, select Workspace settings, then open the Notion app.
Under Workspace connection, click Connect.
Paste in the access token you copied from your Notion connector.
Add the connector to your Notion pages
Notion connections only have access to pages you explicitly share them with. For each page you want to create content in or write to from Attio:
Open the page in Notion and click the settings menu in the top right.
Click Connections, then Manage connections, then Add connections.
Search for your connection and add it to the page.
Note: If a workflow block can't find a page or database, add the connection to that page in Notion and try again.
Use Notion in workflows
Once you've connected Notion, you can use these blocks to create and update Notion content automatically. All three blocks use your workspace connection, automatically split content over 2,000 characters into multiple segments, and return clear errors if a page or database can't be found, the connection lacks a required capability, or a request is rate limited. Rate-limit errors are retried automatically.
Create page
Create page creates a new page nested inside an existing Notion page.
Inputs:
Parent page: Search for a Notion page, or use a page ID from an earlier step. The new page is created inside it.
Title: The title of the new page.
Outputs:
page_id: ID of the created page.
page_url: URL of the created page.
title: The title that was set.
Note: The parent must be a page, not a database. Use the Create page in database block instead if you want to add a row to a database.
Create page in database
Create page in database creates a new page, or row, in a Notion database and sets its properties.
Inputs:
Database: Search for and select a Notion database. You must select this statically rather than with a variable, so Attio can load the database's property schema.
Title: The title of the new page.
Properties (optional): A repeatable list of property values. Click Add property, choose the property, then enter a value. Supported property types are Text, URL, Number, Checkbox, Date, Email, Phone number, Select, Status, Multi-select, and People. To set more than one value on a Multi-select or People property, add that property again as another row.
Outputs:
page_id: ID of the created page.
page_url: URL of the created page.
title: The title that was set.
Note: If a property used in this block is later deleted in Notion, or a select option no longer exists, you'll see a warning in the block configuration and an error at run time.
Add content to page
Add content to page appends or prepends rich text content to an existing Notion page.
Inputs:
Page: Search for a Notion page, or use a page ID from an earlier step.
Content (optional): The rich text to add to the page.
Position: Choose Start of page or End of page.
Outputs:
block_id: ID of the created block.
page_id: ID of the page the block was added to.
Related resources
Now that Notion is connected, learn how to create a workflow to put these blocks to use.