Notion

A database as a board, with you saying which property is which.


Notion connects over OAuth: Connect Notion. During the consent step Notion asks which pages and databases to share, and only what you share is visible to Peractor.

Databases, mapped your way

Notion databases have no fixed schema, so connecting one is a Configure step rather than a single click. Peractor reads the database and asks which property is which:

  • Status property (required) — becomes the task's statuses. A native Status property brings its three groups, so automation can tell "done" from "doing"; a plain Select gives statuses with colours.
  • Assignee property (optional) — a People property.
  • Labels property (optional) — a multi-select, usable by routing rules.

Sensible defaults are pre-picked when your schema has obvious candidates.

How pages sync

  • Each page is a task: the title maps to the task title, and the page's body becomes the description.
  • Status writes update the mapped property. Comments from Peractor are text with links — Notion's API does not take image uploads in comments.
  • Sync is by poll, about every 30 seconds.