Skip to main content

Notion

Notion is a versatile workspace that allows you to write, plan, collaborate, and get organized. It integrates seamlessly with various tools and provides a powerful API to automate and extend its capabilities.

Create new page​

This action allows you to create a new page in Notion under an existing page.

Fields​

  • Notion API Version: The version of the Notion API to use. You can find the current version on Notion's API documentation. The default version is 2022-06-28. Ensure you use a valid date format like YYYY-MM-DD.

  • Parent Page ID: The ID of the page under which the new page will be created. You can find your page ID in the URL of your Notion page. It typically appears after your workspace name in the URL.

  • Page Properties: A JSON object representing the properties of the page to be created. Refer to the Notion API documentation for property names and types. An example of a valid JSON object is {"title": [{"text": {"content": "New Page Title"}}]}.

Create new database​

This action creates a new database under an existing page.

Fields​

  • Parent Page ID: The ID of the page where the new database will be created. You can find this ID in the URL of the page in Notion.

  • Database Name: The name of the database to be created. It cannot be empty and must not start with a space.

  • Icon Emoji: The emoji to be used as the icon for the database. This is optional.

  • Cover URL: The URL of the image to be used as the cover for the database. Ensure it is a valid URL.

  • Properties: The properties of the database in JSON format. An example is {"Name": {"title": {}}, "Description": {"rich_text": {}}}.

Get list of users​

Retrieve a list of users from the Notion workspace.

Fields​

  • API Version: The version of the Notion API you are using. Supported versions can be found in the Notion API documentation. The default is v1.

  • Notion API Version Header: This is a required header for the Notion API. The Notion API version you want to target, formatted as YYYY-MM-DD.

Add comment​

This action allows you to add comments to a page in Notion.

Fields​

  • Page ID: The ID of the page where the comment will be added. You can find this ID in the URL of the Notion page.

  • Comment Text: The text of the comment you want to add. This can be any plain text content.

Retrieve a page​

Retrieve the details of a specific page in Notion using its unique page ID.

Fields​

  • Page ID: The unique identifier of the Notion page you want to retrieve. You can find the Page ID in the URL of the page in Notion.

Retrieve a database​

Retrieve a specific database from Notion using its unique ID.

Fields​

  • Database ID: The unique identifier of the database you want to retrieve. You can find your database ID in the URL of your Notion database.

Search Notion​

Perform a search query within Notion to find pages, databases, and other elements.

Fields​

  • Query Term: The search query term used to find elements in Notion. It can only contain letters, numbers, and spaces.

  • Filter Value: The type of object to search for, such as 'database' or 'page'.

  • Sort Direction: The direction to sort the search results, can be either ascending or descending.

  • Sort By Timestamp: The timestamp to use for sorting, typically 'last_edited_time' or 'created_time'.

  • Page Size: The number of search results to be returned per page, maximum is 100.

Create a block​

Create a new block in a Notion page.

Fields​

  • API Version: The version of the Notion API to use. You can find the latest version on the Notion developer website.

  • Page ID: The ID of the Notion page where you want to create the block. You can find this in the URL of the page.

  • Block Type: The type of block you want to create. Common types include 'paragraph', 'heading_1', 'heading_2'.

  • Content: The text content to include in the block. This will be displayed in the block on the Notion page.

Append Block Children​

Creates and appends new children blocks to a specified parent block using its block_id. You can append up to 100 block children in a single request.

Fields​

  • Block ID: The block ID is the unique identifier for a block in Notion. It can be a page ID, a database ID, or any other block ID where you want to append children.

  • Notion API Version: The version of the Notion API you are working with. The default is 2022-06-28.

  • Children Data: The data for children blocks to append, formatted as an array of block objects. Each block object must have valid content according to your needs, such as headings, paragraphs, etc.