Skip to main content
connic

Notion

Run connic agents when pages are created or changed or comments are added in Notion. Agents reply in the comment's discussion or create new pages.

Modes
Inbound, Outbound
Set up in
Dashboard or connectors/*.yaml
Documentation
Notion docs
Publisher
By connic

Answer pages and comments

When a page or comment matches an inbound connector's events and data source, every agent linked to it starts. An outbound connector on the same Connection posts the result as a comment.

Pick events and a data source
React to new pages, property changes, or new comments, everywhere the integration sees or only in one database.
One subscription, many connectors
The subscription belongs to the integration, so connic routes each event to every matching connector on the Connection.
No loops, no double runs
The integration's own changes are ignored, and an event that Notion sends again doesn't start a second run.
  1. Something happens in Notion

    Someone creates a page, changes its properties, or writes a comment.

    page.created
  2. connic checks the event

    It verifies the signature with the subscription's verification token and reads the page or comment from Notion.

    X-Notion-Signature
  3. Linked agents start

    The run gets the page's title, link, properties and content in Markdown, or the comment's text.

    comment.created
  4. The answer lands in the discussion

    An outbound connector on the same Connection comments on the page, in the discussion of the comment that started the run.

One secret, one subscription

You paste the integration's secret once and create a webhook subscription in Notion with the URL connic shows. Notion then sends a verification token, which connic shows you to paste back.

Your integration, your workspace
The integration belongs to your Notion workspace and only sees what you share with it. You can revoke it in Notion at any time.
Signed events
connic checks every event with the verification token and keeps it once the first signed event has arrived.
Fresh content
Events only name a page or comment, so connic reads the current version from Notion before the agent starts.
notion-verification.http
POST https://connect.connic.co/notion/<connection-id>

{
  "verification_token": "secret_…"
}

Comment on pages or create new ones

An outbound Notion connector posts the agent's output, whether the run answers a page or comes from another connector or a schedule.

Routing
A page_id in the output wins. Without one, a run started from a page on the same Connection comments there, and any other run creates a page in the connector's data source.
Three ways to send
Send after every completed run, give the model a tool to call, or call send_connector from middleware when your code decides.
Markdown pages
New pages take the output as Markdown, with headings and lists. When Notion rate-limits, connic waits and sends again.
output.json
{
  "title": "Weekly churn report",
  "body": "## Summary\n\n4 accounts cancelled."
}
connector-payload.json
{
  "body": "Approved. The refund goes out today.",
  "page_id": "1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}

Where Notion fits

Pick a setup to see what reaches the agent and what it posts back to Notion.

Someone adds a request to a database, and the agent comments with a first assessment.

New page
Inbound Notion
request-triage
Comment on the page
notion-payload.json
{
  "event": "page.created",
  "page_id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "title": "Refund request: order 1042",
  "text": "Order 1042 arrived two weeks late. The customer asks for a refund.",
  "url": "https://www.notion.so/acme/1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}
output.json
{
  "body": "Eligible: delivery was 14 days late. Suggest a full refund of 49 EUR."
}

Someone asks a question in a comment, and the agent answers in the same discussion.

New comment
Inbound Notion
docs-helper
Reply in the discussion
notion-payload.json
{
  "event": "comment.created",
  "page_id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "title": "Onboarding guide",
  "text": "Does this still apply to the EU region?",
  "url": "https://www.notion.so/acme/1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}
output.json
{
  "body": "Yes, except step 4: EU projects pick the region at signup."
}

A draft moves to Ready for review, and the agent reads it and leaves its notes.

Status changed
Inbound Notion
draft-review
Review comment
notion-payload.json
{
  "event": "page.properties_updated",
  "page_id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "title": "Launch post draft",
  "text": "# Launch post\n\nToday we ship…",
  "url": "https://www.notion.so/acme/1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}
output.json
{
  "body": "Two claims need a source, and the pricing paragraph is outdated."
}

A schedule starts the agent every Monday, and it writes the report as a page in a database.

Schedule
Cron
weekly-report
New page in Reports
schedule.json
{
  "schedule": "0 8 * * MON",
  "timezone": "Europe/Berlin"
}
output.json
{
  "title": "Weekly churn report",
  "body": "## Summary\n\n4 accounts cancelled."
}

Notion FAQ

The secret of a Notion internal integration, which you create at notion.so/my-integrations. The integration only sees the pages and databases you share with it.

From the integration. connic ignores events the integration causes, so an agent doesn't start itself again with its own comments.

Notion usually sends an event within a minute. Changes to a page's properties within about a minute arrive as one event, events can arrive out of order, and Notion aims to send each event at most once.

Yes, with type: notion, the events, an optional data source, and the name of a Notion Connection that holds the integration secret.