Notion
App · Notes · 7 actions · 1 trigger
Connect to Notion to search content, look up items in databases, and create or update pages.
Triggers
Start a workflow when something happens in Notion. See how triggers work.
Notion New Page
Triggers when a new page is added to a Notion database
Filters
Narrow which events start a run.
database_idRequiredtitle
Event fields
What a run starts with. Later steps read each field with an @ reference.
idtexttitletexturltextlast_edited_timetext
Actions
| Action | What it does |
|---|---|
| Add content to a page | Add content blocks to an existing Notion page or block. |
| Create page in database | Create a new page in a Notion database, with optional content blocks. |
| Find pages in a database | Find pages in a Notion database, with optional filters and sorting. |
| List databases | List the Notion databases you can access, with an optional search to narrow the results. |
| Retrieve page details | Look up a Notion page and get its title, link, and key details. |
| Search pages | Search for Notion pages that match the text you enter. |
| Update page properties | Update properties on an existing Notion page. |
Add content to a page
Add content blocks to an existing Notion page or block.
Inputs
- Page or block ID
block_idtextRequired - The ID of the page or block to add content to. To add to a page, use the page ID from 'Create page in database' or 'Retrieve page details'.
- Content blocks
childrenlistRequired - Content blocks to add, in Notion's block format. Each block needs a 'type' field and a matching object of that type containing a 'rich_text' list.
Outputs
appendednumber- Number of blocks appended.
has_moretrue/false- Whether more blocks exist.
next_cursortext- Cursor for additional blocks.
statustext- Action execution status.
Example output
{
"appended": 3,
"has_more": false,
"next_cursor": null,
"status": "success"
}Create page in database
Create a new page in a Notion database, with optional content blocks.
Inputs
- Parent database ID
parent_database_idtextRequired - The ID of the database to create the page in. Use the 'List databases' action first to find available database IDs.
- Title
titletextRequired - Page title.
- Properties
propertiesobject - Additional page properties.
- Content blocks
childrenlist - Content blocks to add to the page, in Notion's block format. Each block needs a 'type' field and a matching object of that type containing a 'rich_text' list.
- Title property
title_propertytext - The name of the database's title property, if it is not 'Name'.
Outputs
idtext- Created page ID.
statustext- Action execution status.
titletext- Created page title.
urltext- Created page URL.
Example output
{
"id": "n7m8l9k0j1i2",
"status": "success",
"title": "New Page",
"url": "https://www.notion.so/New-Page-n7m8l9k0j1i2"
}Find pages in a database
Find pages in a Notion database, with optional filters and sorting.
Inputs
- Database ID
database_idtextRequired - Database ID.
- Filter
filterobject - Conditions the pages must match, in Notion's filter format.
- Sorts
sortslist - How to order the results, in Notion's sort format.
- Number of results
page_sizenumber - Number of results to return.
- Start from
start_cursortext - Leave blank for the first set of results. To get more, use the next cursor value from the previous run.
Outputs
countnumber- Number of results returned.
has_moretrue/false- Whether more results are available.
next_cursortext- Cursor for next page.
resultslist- Array of page objects from query.
statustext- Action execution status.
Example output
{
"count": 1,
"has_more": false,
"next_cursor": null,
"results": [
{
"id": "p1q2r3s4t5u6",
"last_edited_time": "2024-01-15T14:20:00.000Z",
"properties": {
"Name": "Task 1",
"Status": "In Progress"
},
"title": "Task 1",
"url": "https://www.notion.so/Task-1-p1q2r3s4t5u6"
}
],
"status": "success"
}List databases
List the Notion databases you can access, with an optional search to narrow the results.
Inputs
- Query
querytext - What to search for.
- Number of results
page_sizenumber - Number of results to return.
- Start from
start_cursortext - Leave blank for the first set of results. To get more, use the next cursor value from the previous run.
Outputs
countnumber- Number of databases returned.
databaseslist- Array of Notion database objects.
has_moretrue/false- Whether more databases are available.
next_cursortext- Cursor for next page.
statustext- Action execution status.
Example output
{
"count": 1,
"databases": [
{
"id": "x9y8z7w6v5u4",
"name": "Tasks Database",
"url": "https://www.notion.so/Tasks-Database-x9y8z7w6v5u4"
}
],
"has_more": false,
"next_cursor": null,
"status": "success"
}Retrieve page details
Look up a Notion page and get its title, link, and key details.
Inputs
- Page ID
page_idtextRequired - Notion page ID.
Outputs
archivedtrue/false- Whether page is archived.
idtext- Notion page ID.
last_edited_timetext- Last edit timestamp.
propertiesobject- Extracted property values from the page.
statustext- Action execution status.
titletext- Page title.
urltext- Page URL.
Example output
{
"archived": false,
"id": "a1b2c3d4e5f6",
"last_edited_time": "2024-01-15T10:30:00.000Z",
"properties": {
"Name": "Meeting Notes",
"Status": "Complete"
},
"status": "success",
"title": "Meeting Notes",
"url": "https://www.notion.so/Meeting-Notes-a1b2c3d4e5f6"
}Search pages
Search for Notion pages that match the text you enter.
Inputs
- Query
querytextRequired - What to search for.
- Number of results
page_sizenumber - Number of results to return.
- Start from
start_cursortext - Leave blank for the first set of results. To get more, use the next cursor value from the previous run.
Outputs
countnumber- Number of pages returned.
has_moretrue/false- Whether more pages are available.
next_cursortext- Cursor for next page.
pageslist- Array of Notion page objects.
statustext- Action execution status.
Example output
{
"count": 1,
"has_more": false,
"next_cursor": null,
"pages": [
{
"id": "a1b2c3d4e5f6",
"last_edited_time": "2024-01-15T10:30:00.000Z",
"title": "Project Planning",
"url": "https://www.notion.so/Project-Planning-a1b2c3d4e5f6"
}
],
"status": "success"
}Update page properties
Update properties on an existing Notion page.
Inputs
- Page ID
page_idtextRequired - Notion page ID.
- Properties
propertiesobjectRequired - The properties to change and their new values, in Notion's property format.
Outputs
idtext- Updated page ID.
last_edited_timetext- Last edit timestamp.
statustext- Action execution status.
titletext- Updated page title.
urltext- Updated page URL.
Example output
{
"id": "a1b2c3d4e5f6",
"last_edited_time": "2024-01-15T10:30:00.000Z",
"status": "success",
"title": "Updated Page",
"url": "https://www.notion.so/Updated-Page-a1b2c3d4e5f6"
}