Notion

Learn how to use Notion with Composio

Overview

SLUG

NOTION

Description

Notion centralizes notes, docs, wikis, and tasks in a unified workspace, letting teams build custom workflows for collaboration and knowledge management

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
bearer_token
string
generic_api_key
stringRequired

Tools

SLUG: NOTION_ADD_PAGE_CONTENT

Appends a single content block to a notion page or a parent block (must be page, toggle, to-do, bulleted/numbered list, callout, or quote); invoke repeatedly to add multiple blocks.

Action Parameters

after
string
content_block
objectRequired
parent_block_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_CREATE_COMMENT

Adds a comment to a notion page (via `parent page id`) or to an existing discussion thread (via `discussion id`); cannot create new discussion threads on specific blocks (inline comments).

Action Parameters

comment
objectRequired
discussion_id
string
parent_page_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_CREATE_DATABASE

Creates a new notion database as a subpage under a specified parent page with a defined properties schema; use this action exclusively for creating new databases.

Action Parameters

parent_id
stringRequired
properties
arrayRequired
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_CREATE_NOTION_PAGE

Creates a new page in a notion workspace.

Action Parameters

cover
string
icon
string
parent_id
stringRequired
title
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_DELETE_BLOCK

Archives a notion block, page, or database using its id, which sets its 'archived' property to true (like moving to "trash" in the ui) and allows it to be restored later.

Action Parameters

block_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_FETCH_COMMENTS

Fetches unresolved comments for a specified notion block or page id.

Action Parameters

block_id
stringRequired
page_size
integerDefaults to 100
start_cursor
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_FETCH_DATA

Simplifies the retrieval of notion items by abstracting the native notion api's complexity.

Action Parameters

get_all
boolean
get_databases
boolean
get_pages
boolean
page_size
integerDefaults to 100
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_FETCH_DATABASE

Fetches a notion database's structural metadata (properties, title, etc.) via its `database id`, not the data entries; `database id` must reference an existing database.

Action Parameters

database_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_FETCH_ROW

Retrieves a notion database row's properties and metadata; use a different action for page content blocks.

Action Parameters

page_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_GET_ABOUT_ME

Retrieves the user object for the bot associated with the current notion integration token, typically to obtain the bot's user id for other api operations.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_GET_ABOUT_USER

Retrieves detailed information about a specific notion user, such as their name, avatar, and email, based on their unique user id.

Action Parameters

user_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_INSERT_ROW_DATABASE

Creates a new page (row) in a specified notion database.

Action Parameters

child_blocks
array
cover
string
database_id
stringRequired
icon
string
properties
array

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_LIST_USERS

Retrieves a paginated list of users (excluding guests) from the notion workspace; the number of users returned per page may be less than the requested `page size`.

Action Parameters

page_size
integerDefaults to 30
start_cursor
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_QUERY_DATABASE

Queries a notion database for pages (rows), where rows are pages and columns are properties; ensure sort property names correspond to existing database properties.

Action Parameters

database_id
stringRequired
page_size
integerDefaults to 2
sorts
array
start_cursor
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_RETRIEVE_COMMENT

Tool to retrieve a specific comment by its id. use when you have a comment id and need to fetch its details.

Action Parameters

comment_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_RETRIEVE_DATABASE_PROPERTY

Tool to retrieve a specific property object of a notion database. use when you need to get details about a single database column/property.

Action Parameters

database_id
stringRequired
property_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_UPDATE_PAGE

Tool to update the properties, icon, cover, or archive status of a page. use when you need to modify existing page attributes.

Action Parameters

archived
boolean
cover
object
icon
object
page_id
stringRequired
properties
object

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_UPDATE_ROW_DATABASE

Updates or archives an existing notion database row (page) using its `row id`, allowing modification of its icon, cover, and/or properties; ensure the target page is accessible and property details (names/ids and values) align with the database schema and specified formats.

Action Parameters

cover
string
delete_row
boolean
icon
string
properties
array
row_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_UPDATE_SCHEMA_DATABASE

Updates an existing notion database's title, description, and/or properties; at least one of these attributes must be provided to effect a change.

Action Parameters

database_id
stringRequired
description
string
properties
array
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: NOTION_APPEND_BLOCK_CHILDREN

Appends new child blocks to a specified parent block or page in notion, ideal for adding content within an existing structure (e.g., list items, toggle content) rather than creating new pages; the parent must be able to accept children.

Action Parameters

after
string
block_id
stringRequired
children
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired