SupportLog InSign Up
DocumentationAPIs & IntegrationsChangelog

Notion

Integrate your application with the Notion API

🚀 Quickstart

Connect to Notion with Tenklo and see data flow in 2 minutes.

Create the integration

In Tenklo (free signup), go to Integrations -> Configure New Integration -> Notion.

Authorize Notion

Go to Connections -> Add Test Connection -> Authorize, then log in to Notion. Later, you'll let your users do the same directly from your app.

Call the Notion API

Let's make your first request to the Notion API (fetch a list of users). Replace the placeholders below with your Environment API key, integration ID, and connection ID:

curl "https://api.tenklo.dev/proxy/v1/users" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Or fetch credentials with the Node SDK or API.

✅ You're connected! Check the Logs tab in Tenklo to inspect requests.

Implement Tenklo in your app

Follow our Auth implementation guide to integrate Tenklo in your app.

To obtain your own production credentials, follow the setup guide linked below.

📚 Notion Integration Guides

Tenklo maintained guides for common use cases.

Official docs: Notion API documentation

🧩 Pre-built syncs & actions for Notion

Explore Nango-provided actions in your dashboard. Extend and customize them to fit your needs.

Others

Function nameDescriptionTypeSource code
append-block-childrenAppend new child blocks to an existing block or page.Action🔗 Github
append-bulleted-listAdds bulleted list items to a page.Action🔗 Github
append-callout-blockAdds a callout block with icon to a page.Action🔗 Github
append-code-blockAdds a code block with syntax highlighting to a page.Action🔗 Github
append-dividerAdds a horizontal divider to a page.Action🔗 Github
append-heading-blockAdds a heading block to a page.Action🔗 Github
append-todo-blockAdds a to-do/checkbox item to a page.Action🔗 Github
archive-pageArchive a page so it is removed from active workspace views.Action🔗 Github
create-commentCreate a comment on a page, block, or discussion threadAction🔗 Github
create-databaseCreates a new database as subpage with defined properties schema.Action🔗 Github
create-data-sourceCreate a Notion data source in its supported parent container.Action🔗 Github
create-pageCreate a new Notion page with properties and optional children.Action🔗 Github
delete-blockDelete or archive a block by ID.Action🔗 Github
duplicate-pageDuplicate a Notion page and its contentAction🔗 Github
get-bot-userRetrieve the bot user associated with the current integration token.Action🔗 Github
get-page-as-markdownRetrieve a page in the current markdown export format if available.Action🔗 Github
get-page-property-itemRetrieve a single property item value from a page.Action🔗 Github
get-userRetrieve a Notion user or bot by user IDAction🔗 Github
list-block-childrenList child blocks for a page or block with pagination.Action🔗 Github
list-commentsList comments for a page or discussion thread.Action🔗 Github
list-data-source-templatesList templates available for a data source.Action🔗 Github
list-usersList Notion users and bots available to the integration.Action🔗 Github
query-database-filteredRetrieves pages from database matching filter conditions.Action🔗 Github
query-database-sortedRetrieves pages from database in sorted order.Action🔗 Github
query-databaseRetrieves filtered and sorted pages from a database with pagination.Action🔗 Github
move-pageMove a Notion page to a new parent location (under another page or into a database).Action🔗 Github
query-data-sourceQuery entries in a Notion data source using filters and sorts.Action🔗 Github
restore-pageRestore a page from trash so it returns to active workspace views.Action🔗 Github
retrieve-blockRetrieve a single block by block ID.Action🔗 Github
retrieve-block-childrenGets paginated list of child blocks within a block or page.Action🔗 Github
retrieve-commentRetrieve a Notion comment by comment IDAction🔗 Github
retrieve-data-sourceRetrieve a Notion data source definition and schema.Action🔗 Github
retrieve-databaseGets database schema and column structure.Action🔗 Github
retrieve-page-propertyGets a specific property value from a page with pagination support.Action🔗 Github
retrieve-pageRetrieve a Notion page and its property values.Action🔗 Github
retrieve-userGets a single user by their ID.Action🔗 Github
search-databasesSearches only databases shared with the integration.Action🔗 Github
search-pagesSearches only pages shared with the integration.Action🔗 Github
searchSearch pages, data sources, and other searchable Notion objects.Action🔗 Github
update-blockUpdate a block's supported fields or rich text content.Action🔗 Github
update-data-sourceUpdate a Notion data source's title, description, or schema properties.Action🔗 Github
update-databaseModifies database title, description, or properties schema.Action🔗 Github
update-page-markdownUpdate page content using markdown commands. Supports targeted edits, full replacement, insertion, and range replacement.Action🔗 Github
update-pageUpdate page properties and other mutable page fields.Action🔗 Github
content-metadataSync page and data source metadata for broad Notion content discovery.Sync🔗 Github
data-source-entriesSync page entries from a Notion data source with properties and timestampsSync🔗 Github
data-source-templatesSync templates available for a Notion data sourceSync🔗 Github
data-sourcesSync Notion data source definitions and schema metadata.Sync🔗 Github
usersSync Notion users and bots visible to the integration.Sync🔗 Github

Northbeam

Previous Page

Notion (MCP)

Next Page

On this page

🚀 Quickstart📚 Notion Integration Guides🧩 Pre-built syncs & actions for Notion