Notion

Parámetros de entrada

• afterstring

  Identifier of an existing block. The new content blocks will be appended immediately after this block. If omitted or null, the new blocks are appended to the end of the parent's children list.

• content_blocksobject[]Obligatorio

  A list of content blocks to be added to the page. Each block can use either the flattened NotionRichText schema or full Notion block structure. ENHANCED: The 'content' field in NotionRichText now automatically detects and parses markdown formatting - supports headers (# ## ###), bold (**text**), italic (*text*), strikethrough (~~text~~), inline code (`code`), links ([text](url)), and more. Maximum of 100 blocks per request.

• parent_block_idstringObligatorio

  Identifier of the parent page or block to which the new content blocks will be added. This parent must be capable of having child blocks. Obtain valid IDs using other Notion actions or API calls.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• afterstring

  Identifier of an existing block. The new content block will be appended immediately after this block. If omitted or null, the new block is appended to the end of the parent's children list.

• content_blockobjectObligatorio

  Include these fields in the json: {'content': 'Some words', 'link': 'https://random-link.com'. For content styling, refer to https://developers.notion.com/reference/rich-text. ENHANCED: The 'content' field now automatically detects and parses markdown formatting - supports bold (**text**), italic (*text*), strikethrough (~~text~~), inline code (`code`), and links ([text](url)). Headers (# ## ###) are handled via block_property.

• parent_block_idstringObligatorio

  Identifier of the parent page or block to which the new content block will be added. This parent must be capable of having child blocks. Obtain valid IDs using other Notion actions or API calls.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• afterstring

  An optional ID of an existing child block. If provided, the new blocks will be inserted directly after this specified block. If omitted, new blocks are appended to the end of the parent's children list.

• block_idstringObligatorio

  Identifier of the parent block or page to which new child blocks will be appended. To find available page IDs and their titles, the `NOTION_FETCH_DATA` action can be utilized.

• childrenobject[]Obligatorio

  A list of block objects to be added as children to the parent block. Each block object must conform to Notion's block structure. A maximum of 100 blocks can be appended in a single request.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• archiveboolean

  Set to `true` to move the page to trash (archive), or `false` to restore it from trash (unarchive). Defaults to `true`.

• page_idstringObligatorio

  The unique identifier (UUID) of the Notion page to be archived or unarchived. This page must already exist in the Notion workspace. Page IDs can be obtained using other Notion actions that retrieve or search for pages.

Parámetros de salida

• dataobjectObligatorio

  Represents the updated Notion page object, reflecting its new archive status with the `in_trash` property updated.

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• commentobjectObligatorio

  Content of the comment as a NotionRichText object. Simplest form: {'content': 'Looks good!'} (optional styling fields: bold, italic, link, etc.). Do NOT wrap this in a list or use Notion API block JSON.

• discussion_idstring

  The ID of an existing discussion thread to which the comment will be added. This is required if `parent_page_id` is not provided.

• parent_page_idstring

  The ID of the Notion page where the comment will be added. This is required if `discussion_id` is not provided. Page IDs can be obtained using other Notion actions that fetch page details or list pages.

Parámetros de salida

• dataobjectObligatorio

  A dictionary containing the full JSON response from the Notion API, which includes the details of the newly created comment object.

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• titlestringObligatorio

  The desired title for the new database. This text will be automatically converted into Notion's rich text format when the database is created.

• parent_idstringObligatorio

  Identifier of the existing Notion page that will contain the new database. This ID must be a valid UUID corresponding to a page within the Notion workspace. It can often be obtained using search functionalities or the `NOTION_FETCH_DATA` action.

• propertiesobject[]Obligatorio

  A list defining the schema (columns) for the new database. Each item in the list is an object representing a property and must specify at least its 'name' (how it will appear in Notion) and 'type' (the kind of data it will hold). Refer to the `PropertySchema` model for full structure details. At least one property of type 'title' is generally required. Common supported property types include: 'title', 'rich_text', 'number', 'select', 'multi_select', 'status', 'date', 'people', 'files', 'checkbox', 'url', 'email', 'phone_number'. Other types like 'formula', 'relation', 'rollup', 'created_time', 'created_by', 'last_edited_time', 'last_edited_by' might also be supported.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• iconstring

  An emoji to be used as the icon for the new page. Must be a single emoji character.

• coverstring

  The URL of an image to be used as the cover for the new page. The URL must be publicly accessible.

• titlestringObligatorio

  The title of the new page to be created.

• parent_idstringObligatorio

  The UUID of the parent page or database under which the new page will be created. This ID must correspond to an existing page or database in the Notion workspace. Use other Notion actions (e.g., for searching or fetching data) to obtain valid parent IDs.

Parámetros de salida

• dataobjectObligatorio

  A dictionary representing the newly created page object, including its ID, parent information, creation time, last edited time, and properties, as returned by the Notion API.

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• block_idstringObligatorio

  Identifier of the block, page, or database to be deleted (archived). To find page IDs and their titles, consider using an action like `NOTION_FETCH_DATA`.

Parámetros de salida

• dataobjectObligatorio

  A dictionary representing the block object that was successfully archived. This object includes an 'archived': true key-value pair, confirming the deletion.

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• titlestring

  An optional new title for the duplicated page. If not provided, the title of the original page will be used, prefixed with 'Copy of'.

• page_idstringObligatorio

  The unique identifier (UUID v4) of the Notion page to be duplicated. Ensure this page exists and is accessible.

• parent_idstringObligatorio

  The unique identifier (UUID v4) of the Notion page or workspace that will serve as the parent for the duplicated page. Ensure this parent exists and is accessible. This ID cannot be the same as `page_id`.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• block_idstringObligatoriouuid

  Identifier (UUID) of the parent Notion block or page whose children are to be fetched. This ID can be for a block or a page (as pages are blocks). To obtain relevant IDs and their titles, consider using actions like 'NOTION_FETCH_DATA' or other actions that list pages or database content.

• page_sizeinteger

  The maximum number of child blocks to return in a single response. The actual number of results may be lower if there are fewer child blocks available or if the end of the list is reached. Maximum allowed value is 100. If unspecified, Notion's default page size will be used.

• start_cursorstring

  An opaque string. If provided, the response will list blocks starting from the position indicated by this cursor. If omitted, the first page of results is returned. Essential for paginating through a large number of child blocks.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• block_idstringObligatoriouuid

  The unique UUID identifier for the Notion block to be retrieved. This can be the ID of a standard block or a page. To find block or page IDs, you might use actions that list page content or search for blocks/pages.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• block_idstringObligatorio

  Identifier for a Notion block or page from which to fetch comments. To find page IDs, use the `NOTION_FETCH_DATA` action to list available pages and their corresponding IDs.

• page_sizeinteger

  The number of comments to return in a single response page. Must be between 1 and 100, inclusive. Default is 100.

• start_cursorstring

  A pagination cursor. If provided, the response will contain the page of results starting after this cursor. If omitted, the first page of results is returned.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• querystring

  An optional search query to filter pages and/or databases by their title or content. If not provided (None or empty string), all accessible items matching the selected type (pages, databases, or both) are returned.

• get_allboolean

  If true, fetches both pages and databases accessible to the Notion integration. Only one of `get_pages`, `get_databases`, or `get_all` can be true.

• get_pagesboolean

  If true, fetches all pages accessible to the Notion integration. Only one of `get_pages`, `get_databases`, or `get_all` can be true.

• page_sizeinteger

  The maximum number of items to retrieve. Must be between 1 and 100, inclusive. Defaults to 100. Note: this action currently only fetches the first page of results, so `page_size` effectively sets the maximum number of items returned.

• get_databasesboolean

  If true, fetches all databases accessible to the Notion integration. Only one of `get_pages`, `get_databases`, or `get_all` can be true.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• database_idstringObligatorio

  The unique identifier of the Notion database whose metadata (structure, properties) is to be retrieved. To obtain a list of `database_id` values and corresponding database titles, use the 'NOTION_FETCH_DATA' action (or a similar action designed for listing/discovering databases). Note: Linked databases are not supported; the ID must reference an actual database, not a linked database.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• page_idstringObligatorio

  The UUID of the Notion page (which represents a row in a database) to retrieve. Each row in a Notion database is a page. You can obtain `page_id` values by using an action that lists database pages (e.g., `NOTION_FETCH_DATA`) to get available page IDs and their titles.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

Sin parámetros.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• user_idstringObligatorio

  The unique identifier of the Notion user whose details are to be retrieved. This ID is used to fetch specific user information.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• page_idstringObligatorio

  Identifier of the Notion page (e.g., '067dd719-a912-471e-a9a3-ac10710e78b4') from which to retrieve the property. Use the 'NOTION_FETCH_DATA' action or similar to discover available page IDs and their titles.

• page_sizeinteger

  For paginated property types (e.g., 'relation', 'rollup', 'rich_text' if content is extensive), this specifies the number of items to return per request. If omitted, Notion's default page size for the property is used.

• property_idstringObligatorio

  Identifier or name of the property to retrieve. For 'title' properties, the ID is always 'title'. For other properties, this can be the property's name as displayed in Notion (e.g., 'Status', 'Assignee') or its unique programmatic ID (e.g., 'N%3A%5B%7C', 'prop_id_example'). Property IDs/names can be found by inspecting the page object or database schema.

• start_cursorstring

  For paginated properties, if a previous request's response indicated `has_more: true`, provide the `next_cursor` value here to fetch the subsequent set of items. Omit if fetching the first page.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• iconstring

  Emoji to be used as the page icon. Must be a single emoji character.

• coverstring

  URL of an external image to set as the page cover. The URL must point to a publicly accessible image.

• propertiesobject[]

  Property values for the new page. IMPORTANT: This field requires a LIST of objects, not a dictionary. Each object in the list defines a property and must include: `name` (the exact name of the property as it appears in Notion), `type` (the property's data type), and `value` (the property's value, formatted as a string according to its type). CORRECT FORMAT EXAMPLE (a list of property objects): [ {"name": "Title", "type": "title", "value": "My new task"}, {"name": "Status", "type": "select", "value": "In Progress"}, {"name": "Tags", "type": "multi_select", "value": "Work,Personal"}, {"name": "Due Date", "type": "date", "value": "2024-06-01T12:00:00.000-04:00"}, {"name": "Completed", "type": "checkbox", "value": "False"} ] INCORRECT FORMAT (e.g., a dictionary instead of a list): { "Title": "My new task", "Status": "In Progress" } Value formatting rules by property type: - `title` or `rich_text`: Plain text string (maximum 2000 characters). - `number`: String representation of a number (e.g., "23.4"). - `select`: The name of an existing option for the select property (e.g., "In Progress"). - `multi_select`: Comma-separated string of existing option names (e.g., "Work,Personal"). - `date`: ISO 8601 formatted date string (e.g., "2024-06-01T12:00:00.000-04:00"). - `people`: Comma-separated string of Notion user IDs. - `checkbox`: String "True" or "False". - `url`: A valid URL string. - `files`: Comma-separated string of URLs. Properties defined in the database schema but omitted from this list will be initialized with default or empty values. Ensure that property names and types correctly match the target database schema.

• database_idstringObligatorio

  Identifier (UUID) of the Notion database where the new page (row) will be inserted. This ID must correspond to an existing database accessible to the integration. Use the `NOTION_FETCH_DATA` action to find available database IDs.

• child_blocksobject[]

  A list of `NotionRichText` objects defining content blocks (e.g., paragraphs, headings) to append to the new page's body. If omitted, the page body will be empty.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• page_sizeinteger

  The desired number of users to retrieve per page. The maximum value is 100.

• start_cursorstring

  If omitted, retrieves the first page of users. Use the 'next_cursor' value from a previous response to get the next page.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• sortsobject[]

  List of sort rules. Each item must use the keys 'property_name' and 'ascending'. Example: [{'property_name': 'Due', 'ascending': False}]

• page_sizeinteger

  The maximum number of items (pages or rows) to return in a single response. Defaults to 2. The actual number of items returned may be less than this value.

• database_idstringObligatorio

  Identifier of the Notion database to query. To discover available database IDs and their corresponding titles, you can use an action like `NOTION_FETCH_DATA` or inspect the database in Notion.

• start_cursorstring

  An opaque cursor for pagination, used to retrieve the next set of results. This value is obtained from the `next_cursor` field in a previous response. If omitted, retrieves results from the beginning.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• comment_idstringObligatorio

  Identifier for the comment to retrieve.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• database_idstringObligatorio

  Identifier for the database.

• property_idstringObligatorio

  Identifier for the property. This can be the property ID or the property name.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• querystring

  The text to search for in page and database titles. If an empty string is provided, all pages and databases accessible to the integration will be returned.

• directionstring

  Specifies the sort direction for the results. Required if `timestamp` is provided. Valid values are `ascending` or `descending`.

• page_sizeinteger

  The number of items to include in the response. Must be an integer between 1 and 100, inclusive. Defaults to 2.

• timestampstring

  The timestamp field to sort the results by. Currently, the only supported value is `last_edited_time`. If provided, `direction` must also be specified.

• filter_valuestring

  Filters the search results by object type. Valid values are `page` or `database`. Defaults to `page`.

• start_cursorstring

  An opaque cursor value returned in a previous response. If provided, the API will return results starting after this cursor, enabling pagination. If `None` or an empty string, results start from the beginning.

• filter_propertystring

  The property to filter the search results by. Currently, the only supported value is `object`, which filters by the type specified in `filter_value`. Defaults to `object`.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• contentstringObligatorio

  The new text content for the block. This is primarily used for text-based blocks like paragraphs, headings, and list items.

• block_idstringObligatorio

  Identifier of the Notion block to be updated. To find a block's ID, other Notion actions that list or retrieve blocks can be used. For updating content within a page (which is also a block), its ID can be obtained using actions like `NOTION_FETCH_DATA` to get page IDs and titles.

• block_typestringObligatorio

  The type of the block to update. Must be one of the supported types: 'paragraph', 'heading_1', 'heading_2', 'heading_3', 'bulleted_list_item', 'numbered_list_item', 'to_do', 'toggle'. The content structure and available `additional_properties` depend on this type.

• additional_propertiesobject

  A dictionary of additional properties to apply to the block, specific to its type. These are merged into the block type's data object (e.g., into the 'paragraph' or 'to_do' object). Examples include `is_toggleable` (boolean) for heading blocks, `checked` (boolean) for 'to_do' blocks, or `color` (string, e.g., 'blue_background') for blocks supporting it. Consult Notion API documentation for supported properties within each block type object.

Parámetros de salida

• dataobjectObligatorio

  A dictionary representing the updated Notion block object, conforming to the Notion API's block object structure.

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• iconobject

  A page icon object (either an emoji object or an external file object).

• coverobject

  A file object for the page cover. Only external file objects are supported for covers.

• page_idstringObligatorio

  Identifier for the Notion page to be updated.

• archivedboolean

  Set to true to archive the page (i.e., send to trash). Set to false to restore a page from trash. Defaults to false.

• propertiesobject

  An object containing the property values to update for the page. The keys are the names or IDs of the property and the values are property value objects. If a page property ID is not included, then it is not changed.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• iconstring

  The emoji to be used as the icon for the page. Must be a single emoji character (e.g., '😻', '🤔').

• coverstring

  URL of an external image to be used as the cover for the page (e.g., 'https://google.com/image.png').

• row_idstringObligatorio

  Identifier (UUID) of the database row (page) to be updated. This ID must be a valid UUID string (e.g., '59833787-2cf9-4fdf-8782-e53db20768a5') corresponding to an existing Notion page. In Notion, database rows are treated as pages.

• delete_rowboolean

  If true, the row (page) will be archived, effectively deleting it from the active view. If false, the row will be updated with other provided data.

• propertiesobject[]

  A list of property values to update for the page. Each item in this list defines a specific property (by its name or ID) and the new value it should take. The format of the `value` depends on the property's type; refer to the main action documentation for detailed formatting guidelines. Properties not included in this list will retain their current values.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not

Parámetros de entrada

• titlestring

  New title for the database. If this field is not provided or is set to `None` (the default value), the database's existing title will remain unchanged.

• propertiesobject[]

  List of property updates. Each item must include at least the 'name' of the column to change plus one of: 'new_type', 'rename', or 'remove'. Example: [ {'name': 'Status', 'new_type': 'select'}, {'name': 'Priority', 'remove': true} ]

• database_idstringObligatorio

  Identifier of the Notion database to update. Use the `NOTION_FETCH_DATA` action or similar tools to get available database IDs and their titles.

• descriptionstring

  New description for the database. If this field is not provided or is set to `None` (the default value), the database's existing description will remain unchanged.

Parámetros de salida

• dataobjectObligatorio

  Data from the action execution

• errorstring

  Error if any occurred during the execution of the action

• successfulbooleanObligatorio

  Whether or not the action execution was successful or not