Add Notion Record

Add one page to a Notion database you shared with Inchat — a record per lead, booking or order.

Quick start

  1. Connect Notion under Settings → Integrations, and tick the database on Notion's screen.
  2. Go to Automate → Workflows and open a workflow. Click + and pick Add Notion Record.
  3. Paste the database's link and click Load.
  4. Fill in Record to add, one box per property, text or {{…}} placeholders.
  5. Set Status to Published in the top toolbar, Save, confirm Publish. Agents: ask an owner or admin.

Watch out

  • It publishes even with nothing connected — a step left that way fails every time it runs, until Notion is connected.
  • Inchat only sees databases you shared with it in Notion. A database added later needs sharing too: ••• → Connections → Inchat.
The Add Steps menu open on the canvas, with Add Notion Record highlighted.
The step panel before Notion is connected, with the link to Integrations.
The Add Notion Record step placed on the canvas.
Details

Getting here

Automate → Workflows, open a workflow, click + on the canvas, then pick Add Notion Record under Add Steps.

Before you start

  • An owner, admin or agent can add this step and save the workflow. Publishing that workflow — the thing that makes it run on live conversations — is an owner or admin action.
  • Building and running workflows depends on your plan; see pricing.
  • Notion connected in Settings → Integrations by an owner or admin, with the target database ticked on Notion's sharing screen. Until connected, the drawer shows a connect card instead of the fields.
  • The connection is per workspace. Anyone who can build a workflow here can point this step at any database the connection was given — not only the one it was set up for.

Set up

  1. Open the workflow and click + where the record belongs.
  2. Pick Add Notion Record.
  3. Paste the database's link — the address of the database page in Notion — and click Load. This reads its title and properties.
  4. Fill in Record to add: one box per property, with text or {{…}} placeholders. Leave a box empty to leave that property blank.
  5. Save the step. To publish: set Status to Published in the toolbar at the top of the editor, click Save, then confirm with Publish. The dropdown on its own changes nothing until you save.

Fields

Notion database link
The database's own URL. Load fetches its title and properties.
Record to add
One box per property, labelled with the property's name and type. Each box takes plain text, or click in and use the {{…}} picker for a variable like {{contact.first_name}} or the customer's last answer.
Limits: Only properties that take a typed value are offered: title, text, number, select, multi-select, status, date, email, phone, URL and checkbox.
When this contact already has a record
Add a new record every time adds a page, as before. Pick a property — usually the phone number — to update the page that already has the same value instead, and add one only when none does.
Limits: Only title, text, phone, email, URL and number properties can be matched on, and the value for it must not come out empty when the step runs.

How it works

  • What leaves Inchat, and when: the instant the step runs, Inchat reads the database's property types, then adds one page with the values you configured, using this workspace's Notion connection.
  • Every {{…}} placeholder is resolved before anything is sent.
  • Values go into properties by NAME. Moving a property in Notion changes nothing; renaming or deleting one makes the step fail with that property's name until you load the database again.
  • Each value is written as its property's type, read fresh on every run. A number property takes 1,250.50; a multi-select takes a comma-separated list; a checkbox takes yes or no.
  • A select or multi-select value Notion has not seen becomes a new option, the same as typing it into Notion.
  • Text longer than 2,000 characters is split into several pieces of the same cell, so Notion accepts it.
  • With a match property, the step first asks Notion for a page whose property equals the value, and updates that page's mapped properties; properties you left empty keep what they had. No match: a new page is added.

When it fails

  • Notion is not connected for this workspace: the step fails with Notion is not connected — connect it in Settings › Integrations., before any request is sent.
  • The database was never shared with Inchat, or the sharing was removed: the step fails with a message pointing to ••• → Connections in Notion.
  • A property you mapped no longer exists: the step fails naming the property, and asks you to load the database again.
  • A value does not fit its property — words in a number property, a date nobody can read, “maybe” in a checkbox: the step fails naming the property and the value, and no record is added.
  • Notion refused the connection and it could not be renewed — usually the connection was removed in Notion: Settings changes to Needs reconnecting, and the step fails until you reconnect.
  • A failed record does not stop the run: the step shows as failed in the run's Activity tab and the flow moves straight to the next one.

Limits

  • It publishes even with nothing connected. The connection card blocks editing the fields in the drawer, but not saving or publishing the workflow.
  • It can add or update one page; it cannot delete a page or read a value back into the conversation.
  • Two runs for the same new contact at the same moment can both find no record and both add one. Delete the extra page; later runs update one of them.
  • Updating needs Notion's Update content permission on the connection. A connection made before that was asked for fails with a message to reconnect Notion.
  • People, relation, files, formula and rollup properties cannot be filled by this step.
  • A database with several data sources is written into its first one.
  • A record is capped at 50 values, each up to 4,000 characters.

Use cases

  • Add a record for every lead that answers an Ask a Question step, so sales can work the pipeline in the Notion board they already use.
  • Log every confirmed booking to the team's Notion calendar database, with the date in a date property.
  • Keep one record per customer, matched on phone, and let the AI Agent update it as the chat goes: AI Agents → Actions → Sync to Google Sheets / Notion uses this same step.

Reading this with an AI assistant? Plain Markdown version.