Notion

Overview

Workspace combining notes, databases, wikis, and project management in one place. Through Langdock’s integration, you can access and manage Notion directly from your conversations.

Authentication: OAuth Category: Productivity & Collaboration Availability: All workspace plans

Available Actions

Get Page Content

notion.getPageContent

Retrieves the content of a specific page or block and all its children from Notion and converts them to markdown

Requires Confirmation: No

Parameters:

• blockId (TEXT, Required): The unique identifier of the Notion page or block whose content you want to retrieve, including all its nested children blocks and their formatted content

Output: Returns the page content converted to markdown format

---

Query Database

notion.queryDatabase

Returns pages from a database with optional filters, sorts, and pagination. Use this action whenever you want to fetch multiple pages from a database

Requires Confirmation: No

Parameters:

• databaseId (TEXT, Required): ID or URL of the database to query

  • filter (TEXT, Optional): Notion filter object JSON. Supports ‘and’/‘or’ compound filters and all type-specific conditions

  • sorts (OBJECT, Optional): Array of Notion sort objects. Example: ['property':'Last ordered','direction':'ascending']

  • pageSize (NUMBER, Optional): Number of results per page (max 100). Defaults to 30

  • startCursor (TEXT, Optional): Cursor from a previous response for pagination

  • filterProperties (TEXT, Optional): Comma-separated property IDs to include in the response

  • returnAll (BOOLEAN, Optional): If true, paginates until all results are collected

  • simplifyOutput (BOOLEAN, Optional): Return simplified pages with id, url, title and flattened properties

Output: Returns array of database pages with their properties and content

---

Create Database

notion.createDatabase

Creates a database as a subpage in the specified parent page, with the specified properties schema. Requires parent page to be an actual page or Wiki

Requires Confirmation: Yes

Parameters:

• parentId (TEXT, Required): ID or URL of the parent PAGE (or wiki) under which the database will be created

  • title (TEXT, Optional): Optional database title

  • properties (OBJECT, Required): Property schema object. Example: 'Name': { 'title': {} }, 'Status': { 'status': {} }, 'Price': { 'number': { 'format': 'dollar' } }

  • icon (TEXT, Optional): Emoji or full icon object

  • cover (TEXT, Optional): External cover URL or full external file object

  • isInline (BOOLEAN, Optional): Create the database inline on the page

Output: Returns the created database with ID, title, and properties schema

---

Update Database

notion.updateDatabase

Updates database metadata (title, description, icon, cover) and/or modifies database properties (add, remove, rename, or change schema)

Requires Confirmation: Yes

Parameters:

• databaseId (TEXT, Required): ID or URL of the database to update

  • title (TEXT, Optional): Optional new database title

  • description (TEXT, Optional): Optional new database description

  • properties (OBJECT, Optional): JSON object describing property changes. Use null to remove a property, provide { name: 'New name' } to rename, or pass a property schema object to change type/options

  • icon (TEXT, Optional): Emoji or full icon object

  • cover (TEXT, Optional): External cover URL or full external file object

Output: Returns the updated database with new metadata and properties

---

Get Page Details

notion.getPageDetails

Retrieves detailed information about a specific Notion page including its properties, metadata, and structure

Requires Confirmation: No

Parameters:

• pageId (TEXT, Required): The unique identifier of the Notion page you want to retrieve information about

Output: Returns page details including ID, title, properties, and metadata

---

Find Pages

notion.findPages

Searches for pages in your Notion workspace by title

Requires Confirmation: No

Parameters:

• query (TEXT, Optional): Search term used to find pages by their titles

Output: Returns array of pages matching the search criteria

---

Find Databases

notion.findDatabases

Searches for databases in your Notion workspace by title

Requires Confirmation: No

Parameters:

• query (TEXT, Optional): Search term used to find databases by their titles

Output: Returns array of databases matching the search criteria

---

Get Database Details

notion.getDatabaseDetails

Retrieves detailed information about a specific Notion database including its properties, metadata, and structure

Requires Confirmation: No

Parameters:

• databaseId (TEXT, Required): The unique identifier of the Notion database you want to retrieve information about

Output: Returns database details including ID, title, properties schema, and metadata

---

Search

notion.search

Searches across your entire Notion workspace or within a specific database for pages and content

Requires Confirmation: No

Parameters:

• query (TEXT, Optional): Search term to find pages or databases. Searches are case-insensitive and match partial words

  • databaseId (TEXT, Optional): Optional: Search within a specific database instead of the entire workspace

  • objectType (SELECT, Optional): Filter results by type. Choose ‘page’ for pages only or ‘database’ for databases only

  • propertyFilters (TEXT, Optional): Filter database pages by property values (requires database ID). Provide as JSON object

  • pageSize (NUMBER, Optional): Number of results to return per page. Default is 30, maximum is 100

  • sortBy (SELECT, Optional): Sort results by creation time or last edited time

  • sortDirection (SELECT, Optional): Sort order for results

  • createdBy (TEXT, Optional): Filter results by the user who created the page or database

  • lastEditedBy (TEXT, Optional): Filter results by the user who last edited the page or database

  • startCursor (TEXT, Optional): Pagination cursor from previous search results

Output: Returns array of pages and databases matching the search criteria

---

Create Page

notion.createPage

Creates a new page in Notion, either as a database entry or as a child of another page

Requires Confirmation: Yes

Parameters:

• parentId (TEXT, Required): The ID of the parent database or page where the new page will be created

  • parentType (SELECT, Optional): Type of parent where the page will be created

  • title (TEXT, Optional): The title of the new page

  • properties (OBJECT, Optional): Properties for the new page as a JSON object

  • content (TEXT, Optional): The content of the page. Can be plain text (will be converted to paragraphs) or an array of Notion blocks

  • icon (TEXT, Optional): An emoji or URL for the page icon

  • cover (TEXT, Optional): URL of an image to use as the page cover

  • createInPersonalRoot (BOOLEAN, Optional): When enabled and parentId is ‘workspace’ or ‘root’, creates the page at your personal workspace root

Output: Returns the created page with ID, title, and properties

---

Update Page

notion.updatePage

Updates a page’s properties and/or a specific block on that page. Use page fields for database/page metadata; use block fields to edit the content of an individual block

Requires Confirmation: Yes

Parameters:

• pageId (TEXT, Optional): ID of the page to update (properties, icon, cover, trash)

  • properties (TEXT, Optional): JSON object of properties to update

  • icon (TEXT, Optional): Emoji character or full Notion icon object

  • cover (TEXT, Optional): URL string or full Notion external file object

  • inTrash (BOOLEAN, Optional): Set true to move the page to trash, false to restore

  • blockId (TEXT, Optional): ID of the block to update (content editing)

  • blockType (TEXT, Optional): Block type to update (e.g., ‘paragraph’, ‘heading_1’, ‘heading_2’, ‘heading_3’, ‘to_do’, ‘bulleted_list_item’, ‘numbered_list_item’)

  • blockText (TEXT, Optional): Text content for the block (converted to rich_text)

  • blockChecked (BOOLEAN, Optional): Only for to_do blocks. true/false

  • blockPayload (TEXT, Optional): Advanced: full JSON body for the block update (overrides blockType/blockText)

  • blockArchived (BOOLEAN, Optional): Set true to archive the block, false to unarchive

Output: Returns the updated page or block with new values

Triggers

Updated Page

notion.updatedPage

Triggers when pages are updated

Requires Confirmation: No

Parameters:

• pageId (TEXT, Optional): ID of the page to monitor for updates

Output: Returns the result of the operation

---

Updated Database Item

notion.updatedDatabaseItem

Triggers when items in the database are updated

Requires Confirmation: No

Parameters:

• databaseId (TEXT, Required): ID of the database to monitor for updated items

Output: Returns the result of the operation

---

New Database Item

notion.newDatabaseItem

Triggers when new database items are added

Requires Confirmation: No

Parameters:

• databaseId (TEXT, Required): ID of the database to monitor for new items

Output: Returns the result of the operation

Common Use Cases

• Data Management — Manage and organize your Notion data

• Automation — Automate workflows with Notion

• Reporting — Generate insights and reports

• Integration — Connect Notion with other tools

Best Practices

1

Getting Started

• Enable the Notion integration in your workspace settings

• Authenticate using OAuth

• Test the connection with a simple read operation

• Explore available actions for your use case

2

Important Considerations

• Ensure proper authentication credentials

• Respect rate limits and API quotas

• Review data privacy settings

• Test operations in a safe environment first

Troubleshooting

Issue	Solution
Authentication failed	Verify your OAuth credentials
Rate limit exceeded	Reduce request frequency
Data not found	Check permissions and data availability
Connection timeout	Verify network connectivity

Support

For additional help with the Notion integration, contact [email protected]