Notion

The integration targets Notion API version 2026-03-11 and preserves Notion’s snake-case request and response fields. Inputs and outputs use the official @notionhq/client types.

Connect to Notion

OAuth is the preferred connection. It supports actions and webhook triggers across content, comments, users, and Notion agents. A personal access token can run actions with its Notion API capability, but it can’t own a webhook subscription or list every workspace user. Use notionAccount("name") to select a named project account. Each action declares its least Notion capability, and deployment fails when the selected connection can’t satisfy it.

Example

automations/archive-completed-notion-pages.automation.ts

import { automation } from "automate.ax"
import { notion } from "automate.ax/notion"

export default automation("Archive completed Notion pages", () => {
  const updated = notion.onPagePropertiesUpdated()

  notion.updatePage({
    page_id: updated.entity.id,
    in_trash: true,
  })
})

Every authenticated webhook delivery starts an ordinary root context. Use correlation when a later Notion event belongs with an earlier action occurrence. Notion’s current limits are checked before execution, including cursor page sizes, array bounds, URL and expression lengths, current field names, and file-upload mode invariants. The client retries rate limits and safe transient failures according to the official SDK policy. Notion webhooks require OAuth. Automate.ax verifies the signature over the exact request body, routes by stable workspace ID, and deduplicates retries by Notion event ID.

Provider setup

Configure the OAuth client ID and secret plus the verification token for the static Notion webhook subscription. Notion sends the verification token during subscription setup; capture it with a disposable secret-safe endpoint, configure NOTION_WEBHOOK_VERIFICATION_TOKEN, then set the production callback to /api/v1/events/notion. Notion agent APIs are public beta and additionally require a workspace plan and integration access that supports agents.

Exports

import {
  notion,
  notionAccount,
  NotionClient,
  getNotionApi,
} from "automate.ax/notion"

notion contains the packaged Notion actions and triggers.
notionAccount("name") selects a named Notion connection.
NotionClient is the official Notion client class returned by getNotionApi.
getNotionApi creates the authenticated Notion API helper for a custom account-backed action.

Built-in triggers

Built-in actions

Runtime utilities

Integrations

Connect to Notion

Example

Provider setup

Exports

Triggers

Actions

​Connect to Notion

​Example

​Provider setup

​Exports

​Triggers

​Actions

Connect to Notion

Example

Provider setup

Exports

Triggers

Actions