Provided free and as is, without warranty of any kind — including merchantability, fitness for a particular purpose, and the accuracy or completeness of any result. See the licence. You are responsible for checking what this produces before relying on it.

Notion

Read and write Notion pages and databases from an InTouch job, using the official Notion REST API.

Base URL: https://api.notion.com
Auth: Authorization: Bearer <token>
Required version header: Notion-Version: 2026-03-11
Grounded in: https://developers.notion.com/reference/intro

This tool uses the Python standard library only — no external packages.

Operations

operation	Notion endpoint	What it does
`search`	`POST /v1/search`	Find pages / data sources by title
`retrieve_page`	`GET /v1/pages/{page_id}`	Fetch a single page's properties
`query_database`	`POST /v1/databases/{database_id}/query`	List rows in a database, with optional filter
`create_page`	`POST /v1/pages`	Create a new page under a page or database

Inputs

name	required	used by	description
`apiKey`	yes	all	Notion integration token (see below)
`operation`	yes	all	One of the four operations above
`query`	no	search	Title text to match (empty = all items shared with the integration)
`pageId`	no	retrieve_page	UUID of the page to retrieve
`databaseId`	no	query_database	UUID of the database to query
`filter`	no	query_database	JSON filter object string
`parentId`	no	create_page	UUID of the parent page or database
`parentType`	no	create_page	`page_id` (default) or `database_id`
`title`	no	create_page	Title text for the new page
`pageSize`	no	search/query	Max results per page, 1–100 (default 20)

Outputs

key	description
`result`	The raw JSON response body from Notion (as a string)
`status`	The HTTP status code (`200`, `400`, `404`, …)

A 4xx/5xx from Notion does not crash the step — result holds the error body and an error field carries the message. A transport-level failure (DNS/timeout/refused) prints an error envelope and exits non-zero (step FAILS).

How to get the apiKey

Go to https://www.notion.com/my-integrations and create a new internal integration.
Copy the Internal Integration Token (starts with ntn_ or secret_). This is your apiKey.
In Notion, open each page or database you want the tool to access, click the … menu → Connections → add your integration. The API can only see content explicitly shared with the integration.

Examples

Search for pages titled "Roadmap"

operation = search
query     = Roadmap
apiKey    = ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Create a page under an existing page

operation  = create_page
parentType = page_id
parentId   = 7c8f...   (UUID of the parent page)
title      = Meeting notes 2026-06-13
apiKey     = ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Query a database for completed items

operation  = query_database
databaseId = a1b2...   (UUID of the database)
filter     = {"property":"Done","checkbox":{"equals":true}}
apiKey     = ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

error
result
status

Input Properties

Every property this tool accepts, from its own tool.iml.

Property	Type	Required	Default	Description
`apiKey`	string	yes	—	DEPRECATED — bind an API Key credential to the task with `credentialName` instead. A key pasted here is stored in the workflow definition in clear and appears in every export of it. Still honoured for workflows built before the change.
`operation`	string	yes	—	One of: search, retrieve_page, query_database, create_page
`query`	string	no	—	search: the text to match against page/data source titles (optional; empty returns all shared items).
`pageId`	string	no	—	retrieve_page: the UUID of the page to retrieve.
`databaseId`	string	no	—	query_database: the UUID of the database to query.
`filter`	string	no	—	query_database: optional JSON filter object string, e.g. {"property":"Done","checkbox":{"equals":true}}.
`parentId`	string	no	—	create_page: UUID of the parent page or database (used with parentType).
`parentType`	string	no	`page_id`	create_page: 'page_id' or 'database_id' — what parentId refers to.
`title`	string	no	—	create_page: the title text for the new page.
`pageSize`	string	no	`20`	search/query_database: max results per page (1-100).