Skip to main content

Documentation Index

Fetch the complete documentation index at: https://nango.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
🚀 Quickstart

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

Create the integration

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

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.
3

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 secret key, integration ID, and connection ID:
curl "https://api.nango.dev/proxy/v1/users" \
  -H "Authorization: Bearer <NANGO-SECRET-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 Nango to inspect requests.
4

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

​
📚 Notion Integration Guides

Nango maintained guides for common use cases. Official docs: Notion API documentation

​
🧩 Pre-built syncs & actions for Notion

Enable them in your dashboard. Extend and customize to fit your needs.

​
Blocks

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
delete-blockDelete or archive a block by ID.Action🔗 Github
list-block-childrenList child blocks for a page or block with pagination.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
update-blockUpdate a block’s supported fields or rich text content.Action🔗 Github

​
Comments

Function nameDescriptionTypeSource code
create-commentCreate a comment on a page, block, or discussion threadAction🔗 Github
list-commentsList comments for a page or discussion thread.Action🔗 Github
retrieve-commentRetrieve a Notion comment by comment IDAction🔗 Github

​
Data Sources

Function nameDescriptionTypeSource code
create-data-sourceCreate a Notion data source in its supported parent container.Action🔗 Github
list-data-source-templatesList templates available for a data source.Action🔗 Github
query-data-sourceQuery entries in a Notion data source using filters and sorts.Action🔗 Github
retrieve-data-sourceRetrieve a Notion data source definition and schema.Action🔗 Github
update-data-sourceUpdate a Notion data source’s title, description, or schema properties.Action🔗 Github

​
Databases

Function nameDescriptionTypeSource code
create-databaseCreates a new database as subpage with defined properties schema.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
retrieve-databaseGets database schema and column structure.Action🔗 Github
update-databaseModifies database title, description, or properties schema.Action🔗 Github

​
Pages

Function nameDescriptionTypeSource code
archive-pageArchive a page so it is removed from active workspace views.Action🔗 Github
create-pageCreate a new Notion page with properties and optional children.Action🔗 Github
duplicate-pageDuplicate a Notion page and its contentAction🔗 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
move-pageMove a Notion page to a new parent location (under another page or into a database).Action🔗 Github
restore-pageRestore a page from trash so it returns to active workspace views.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
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
Function nameDescriptionTypeSource code
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

​
Users

Function nameDescriptionTypeSource code
get-bot-userRetrieve the bot user associated with the current integration token.Action🔗 Github
get-userRetrieve a Notion user or bot by user IDAction🔗 Github
list-usersList Notion users and bots available to the integration.Action🔗 Github
retrieve-userGets a single user by their ID.Action🔗 Github

​
Others

Function nameDescriptionTypeSource code
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