Actions16
Overview
This node interacts with Notion's API to perform advanced operations on Notion blocks. Specifically, the "Get" operation for the "Block" resource retrieves detailed information about a single block in a Notion workspace by its unique Block ID.
Use cases include:
- Fetching content or metadata of a specific block (e.g., paragraph, heading, image) within a Notion page.
- Integrating Notion block data into workflows for further processing or display.
- Automating retrieval of block details for reporting or synchronization purposes.
Example: You have a Notion page with various blocks and want to programmatically get the content and properties of a particular block to use in another system or workflow.
Properties
| Name | Meaning |
|---|---|
| Block ID | The unique identifier of the Notion block to retrieve. |
| Additional Fields | Collection of optional fields that can be set when applicable (Icon, Cover, Archive). Note: For the "Get" operation on Block, these additional fields are not used. |
Output
The output is a JSON object representing the retrieved Notion block. It contains all the block's properties as returned by the Notion API, including type, content, formatting, and any nested data relevant to that block.
No binary data output is produced by this operation.
Example output structure (simplified):
{
"object": "block",
"id": "block-id-string",
"type": "paragraph",
"paragraph": {
"text": [
{
"type": "text",
"text": {
"content": "Block content here",
"link": null
},
"annotations": {
"bold": false,
"italic": false,
"underline": false,
"strikethrough": false,
"code": false,
"color": "default"
},
"plain_text": "Block content here",
"href": null
}
]
},
"has_children": false,
"archived": false
}
Dependencies
- Requires valid Notion API credentials (an API key or token) configured in n8n.
- Uses Notion's official REST API endpoints.
- The node depends on utility functions for API requests and input parsing bundled within the node's codebase.
Troubleshooting
- Invalid Notion API credentials: The node will throw an error if the provided credentials are invalid or missing. Ensure your API key/token is correctly set up in n8n credentials.
- Block ID not found or invalid: If the Block ID does not exist or is malformed, the Notion API will return an error. Verify the Block ID is correct.
- API rate limits: Frequent calls may hit Notion's rate limits causing errors. Implement retry logic or reduce request frequency.
- Network issues: Connectivity problems can cause request failures. Check network access to Notion API endpoints.