Page
RequiredTextA page ID works here — a page is a block.
Example value (replace with your own):
248104cd-477e-80a9-8a1b-e4f8b0f8c1d2
In this guide
Read a Document
The blocks making up a page's content.
What this action does #
First, connect Notion in Services. Then open Actions → + → Notion and choose Read a Document.
To find this direct request action, choose Every Notion endpoint in the integration’s picker. The setup guide also explains the dedicated forms for common tasks.
More about this action
Paged in the query string, unlike Notion's POST endpoints which page in the body. Nested blocks are not expanded: a block with `has_children` true needs a second call with its own ID.
Inputs to fill in #
Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.
Page Size
OptionalWhole number1–100.
Example value (replace with your own):
100
Start Cursor
OptionalTextSupply a text value for this input.
What comes back #
In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.
| Returned field | Type | Meaning |
|---|---|---|
results | array | A list of values. |
results[].id | string | Text value. |
results[].type | string | paragraph, heading_1, … |
results[].has_children | boolean | True or false. |
results[].paragraph | object | A group of named values. |
results[].paragraph.rich_text | array | A list of values. |
results[].paragraph.rich_text[].plain_text | string | The text without formatting. |
Run it from Shortcuts #
- Give the action a recognizable name and tap Save.
- In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
- Supply any Param or File slots you bound in the inputs, then run the shortcut.
If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.
This action supports multiple pages of results. Open its Fetch setting to retrieve more pages when one page is not enough. Each page adds a service request.
Advanced reference #
Request, permissions, and identifiers
Request: GET https://api.notion.com/v1/blocks/{block_id}/children
Action identifier: notion.blocks.children.list.v1
No additional per-action permissions are declared in the app’s catalog. The integration’s connection and account access rules still apply.
| Input | Request key | Location |
|---|---|---|
| Page | block_id | path |
| Page Size | page_size | query |
| Start Cursor | start_cursor | query |