Skip to main content

Notion

The Notion integration turns a document into a Notion page or database item — schema-aware, so it maps your document fields onto the right Notion properties.

What you can do​

  • Send to Notion from a document — pick a workspace and a database, then fill a form that shows one input per database field (files map to a Notion "files" property). Or create a subpage under a page you choose.
  • Map document fields into a database for continuous sync, so processed documents flow into a Notion table automatically.
  • Create pages and database items from workflows — e.g. when an invoice email arrives.

Setup (self-hosting)​

The richest experience uses a Notion public OAuth integration, which supports connecting multiple Notion workspaces:

  1. Register an integration at notion.so/my-integrations with type Public and Read/Insert content capabilities.
  2. Add the redirect URI <your-app-url>/oauth/notion/callback.
  3. Set the credentials: 
    NOTION_CLIENT_ID=your_client_id
    NOTION_CLIENT_SECRET=your_client_secret

No OAuth app? No problem. If you leave NOTION_CLIENT_ID/NOTION_CLIENT_SECRET unset (common when self-hosting), you can still connect Notion by pasting an internal integration token under Settings → Integrations → Notion.

Connecting and using it​

  1. Go to Settings → Integrations → Notion and connect (OAuth) or paste an internal token.
  2. Share the target Notion database or page with the integration in Notion, so it has access.
  3. Open a document and click Send to Notion, choose a database (or a parent page), and submit.
  4. To automate it, add a Send to Notion action to a workflow; database-item properties are supplied as a template resolved against the live database schema at run time.
Last updated on