Notion tool common issues

Here are some common errors and issues with the Notion tool and steps to resolve or troubleshoot them.

Relation property not displaying

The Notion tool only supports displaying the data relation property for two-way relations (opens in a new tab). When you connect two Notion databases with a two-way relationship, you can select or filter by the relation property when working with the Notion tool's Database Page resource.

To enable two-way relations, edit the relation property in Notion and enable the Show on [name of related database] option to create a reverse relation. Select a name to use for the relation in the new context. The relation is now accessible in nuhello when filtering or selecting.

If you need to work with Notion databases with one-way relationship, you can use the HTTP Request with your existing Notion credentials. For example, to update a one-way relationship, you can send a PATCH request to the following URL:

https://api.notion.com/v1/pages/<page_id>

Enable Send Body, set the Body Content Type to JSON, and set Specify Body to Using JSON. Afterward, you can enter a JSON object like the following into the JSON field:

{
	"properties": {
		"Account": {
			"relation": [
				{
					"id": "<your_relation_ID>"
				}
			]
		}
	}
}

Create toggle heading

The Notion tool allows you to create headings and toggles when adding blocks to Page, Database Page, or Block resources. Creating toggleable headings isn't yet supported by the Notion tool itself.

You can work around this be creating a regular heading and then modifying it to enable the is_toggleable property (opens in a new tab):

Add a heading with Notion tool.
Select the resource you want to add a heading to:
- To add a new page with a heading, select the Page or Database Page resources with the Create operation.
- To add a heading to an existing page, select the Block resource with the Append After operation.
Select Add Block and set the Type Name or ID to either Heading 1, Heading 2, or Heading 3.
Add an HTTP Request tool connected to the Notion tool and select the GET method.
Set the URL to https://api.notion.com/v1/blocks/<block_ID>. For example, if your added the heading to an existing page, you could use the following URL: https://api.notion.com/v1/blocks/{{ $json.results[0].id }}. If you created a new page instead of appending a block, you may need to discover the block ID by querying the page contents first.
Select Predefined Credential Type and connect your existing Notion credentials.
Add an Edit Fields (Set) tool after the HTTP Request tool.
Add heading_1.is_toggleable as a new Boolean field set to true. Swap heading_1 for a different heading number as necessary.
Add a second HTTP Request tool after the Edit Fields (Set) tool.
Set the Method to PATCH and use https://api.notion.com/v1/blocks/{{ $json.id }} as the URL value.
Select Predefined Credential Type and connect your existing Notion credentials.
Enable Send Body and set a parameter.
Set the parameter Name to heading_1 (substitute heading_1 for the heading level you are using).
Set the parameter Value to {{ $json.heading_1 }} (substitute heading_1 for the heading level you are using).

The above sequence will create a regular heading block. It will query the newly created header, add the is_toggleable property, and update the heading block.

Handle null and empty values

You may receive a validation error when working with the Notion tool if you submit fields with empty or null values. This can occur any time you populate fields from previous tools when that data is missing.

To work around this, check for the existence of the field data before sending it to Notion or use a default value.

To check for the data before executing the Notion tool, use an If tool to check whether the field is unset. This allows you to use the Edit Fields (Set) tool to conditionally remove the field when it doesn't have a valid value.

As an alternative, you can set a default value if the incoming data doesn't provide one.

Overview Overview