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_idRequired
title

Event fields

What a run starts with. Later steps read each field with an @ reference.

idtext
titletext
urltext
last_edited_timetext

Actions

ActionWhat it does
Add content to a pageAdd content blocks to an existing Notion page or block.
Create page in databaseCreate a new page in a Notion database, with optional content blocks.
Find pages in a databaseFind pages in a Notion database, with optional filters and sorting.
List databasesList the Notion databases you can access, with an optional search to narrow the results.
Retrieve page detailsLook up a Notion page and get its title, link, and key details.
Search pagesSearch for Notion pages that match the text you enter.
Update page propertiesUpdate 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 IDblock_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 blockschildrenlistRequired
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 IDparent_database_idtextRequired
The ID of the database to create the page in. Use the 'List databases' action first to find available database IDs.
TitletitletextRequired
Page title.
Propertiespropertiesobject
Additional page properties.
Content blockschildrenlist
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 propertytitle_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 IDdatabase_idtextRequired
Database ID.
Filterfilterobject
Conditions the pages must match, in Notion's filter format.
Sortssortslist
How to order the results, in Notion's sort format.
Number of resultspage_sizenumber
Number of results to return.
Start fromstart_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

Queryquerytext
What to search for.
Number of resultspage_sizenumber
Number of results to return.
Start fromstart_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 IDpage_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

QueryquerytextRequired
What to search for.
Number of resultspage_sizenumber
Number of results to return.
Start fromstart_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 IDpage_idtextRequired
Notion page ID.
PropertiespropertiesobjectRequired
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"
}

On this page