Notion
Manage Notion pages
Integrate with Notion into the workflow. Can read page, read database, create page, create database, append content, query database, and search workspace.
Read content from a Notion page
| Parameter | Type | Required | Description |
|---|
pageId | string | Yes | No description |
| Parameter | Type | Description |
|---|
url | string | Notion page URL |
created_time | string | ISO 8601 creation timestamp |
last_edited_time | string | ISO 8601 last edit timestamp |
content | string | Page content in markdown format |
title | string | Page title |
Read database information and structure from Notion
| Parameter | Type | Required | Description |
|---|
databaseId | string | Yes | No description |
| Parameter | Type | Description |
|---|
id | string | Database UUID |
url | string | Notion database URL |
created_time | string | ISO 8601 creation timestamp |
last_edited_time | string | ISO 8601 last edit timestamp |
properties | object | Database properties schema |
title | string | Database title |
Append content to a Notion page
| Parameter | Type | Required | Description |
|---|
pageId | string | Yes | No description |
content | string | Yes | No description |
| Parameter | Type | Description |
|---|
appended | boolean | Whether content was successfully appended |
Create a new page in Notion
| Parameter | Type | Required | Description |
|---|
parentId | string | Yes | No description |
title | string | No | No description |
content | string | No | No description |
| Parameter | Type | Description |
|---|
id | string | Page UUID |
url | string | Notion page URL |
created_time | string | ISO 8601 creation timestamp |
last_edited_time | string | ISO 8601 last edit timestamp |
title | string | Page title |
Update properties of a Notion page
| Parameter | Type | Required | Description |
|---|
pageId | string | Yes | No description |
properties | json | Yes | No description |
| Parameter | Type | Description |
|---|
id | string | Page UUID |
url | string | Notion page URL |
last_edited_time | string | ISO 8601 last edit timestamp |
title | string | Page title |
Query and filter Notion database entries with advanced filtering
| Parameter | Type | Required | Description |
|---|
databaseId | string | Yes | No description |
filter | string | No | No description |
sorts | string | No | No description |
pageSize | number | No | No description |
| Parameter | Type | Description |
|---|
results | array | Array of page objects from the database |
↳ object | string | Always "page" |
↳ id | string | Page UUID |
↳ created_time | string | ISO 8601 creation timestamp |
↳ last_edited_time | string | ISO 8601 last edit timestamp |
↳ created_by | object | Partial user object |
↳ object | string | Always "user" |
↳ id | string | User UUID |
↳ last_edited_by | object | Partial user object |
↳ object | string | Always "user" |
↳ id | string | User UUID |
↳ archived | boolean | Whether the page is archived |
↳ in_trash | boolean | Whether the page is in trash |
↳ url | string | Notion page URL |
↳ public_url | string | Public web URL if shared, null otherwise |
↳ parent | object | Parent object specifying hierarchical relationship |
↳ type | string | Parent type: "database_id", "data_source_id", "page_id", "workspace", or "block_id" |
↳ database_id | string | Parent database UUID (if type is database_id) |
↳ data_source_id | string | Parent data source UUID (if type is data_source_id) |
↳ page_id | string | Parent page UUID (if type is page_id) |
↳ workspace | boolean | True if parent is workspace (if type is workspace) |
↳ block_id | string | Parent block UUID (if type is block_id) |
↳ icon | object | Page/database icon (emoji, custom_emoji, or file) |
↳ url | string | Authenticated URL valid for one hour |
↳ expiry_time | string | ISO 8601 timestamp when URL expires |
↳ cover | object | Page/database cover image |
↳ type | string | File type: "file", "file_upload", or "external" |
↳ file | object | Notion-hosted file object (when type is "file") |
↳ url | string | Authenticated URL valid for one hour |
↳ expiry_time | string | ISO 8601 timestamp when URL expires |
↳ file_upload | object | API-uploaded file object (when type is "file_upload") |
↳ id | string | File upload UUID |
↳ external | object | External file object (when type is "external") |
↳ url | string | External file URL (never expires) |
↳ properties | object | Page property values (structure depends on parent type - database properties or title only) |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for next page of results |
total_results | number | Number of results returned |
Search across all pages and databases in Notion workspace
| Parameter | Type | Required | Description |
|---|
query | string | No | No description |
filterType | string | No | Filter by object type: "page", "database", or leave empty for all |
pageSize | number | No | No description |
| Parameter | Type | Description |
|---|
results | array | Array of search results (pages and/or databases) |
↳ object | string | Object type: "page" or "database" |
↳ id | string | Object UUID |
↳ created_time | string | ISO 8601 creation timestamp |
↳ last_edited_time | string | ISO 8601 last edit timestamp |
↳ created_by | object | Partial user object |
↳ object | string | Always "user" |
↳ id | string | User UUID |
↳ last_edited_by | object | Partial user object |
↳ object | string | Always "user" |
↳ id | string | User UUID |
↳ archived | boolean | Whether the object is archived |
↳ in_trash | boolean | Whether the object is in trash |
↳ url | string | Object URL |
↳ public_url | string | Public web URL if shared |
↳ parent | object | Parent object specifying hierarchical relationship |
↳ type | string | Parent type: "database_id", "data_source_id", "page_id", "workspace", or "block_id" |
↳ database_id | string | Parent database UUID (if type is database_id) |
↳ data_source_id | string | Parent data source UUID (if type is data_source_id) |
↳ page_id | string | Parent page UUID (if type is page_id) |
↳ workspace | boolean | True if parent is workspace (if type is workspace) |
↳ block_id | string | Parent block UUID (if type is block_id) |
↳ properties | object | Object properties |
has_more | boolean | Whether more results are available |
next_cursor | string | Cursor for next page of results |
total_results | number | Number of results returned |
Create a new database in Notion with custom properties
| Parameter | Type | Required | Description |
|---|
parentId | string | Yes | No description |
title | string | Yes | No description |
properties | json | No | Database properties as JSON object (optional, will create a default "Name" property if empty) |
| Parameter | Type | Description |
|---|
id | string | Database UUID |
url | string | Notion database URL |
created_time | string | ISO 8601 creation timestamp |
properties | object | Database properties schema |
title | string | Database title |
| Parameter | Type | Required | Description |
|---|
databaseId | string | Yes | No description |
properties | json | Yes | Row properties as JSON object matching the database schema (e.g., {"Name": {"title": [{"text": {"content": "Task 1"}}]}, "Status": {"select": {"name": "Done"}}}) |
| Parameter | Type | Description |
|---|
id | string | Page UUID |
url | string | Notion page URL |
created_time | string | ISO 8601 creation timestamp |
last_edited_time | string | ISO 8601 last edit timestamp |
title | string | Row title |
