Integrate the Notion API.Caddi writes and runs the integration for you.
Notion has a REST API. Self-serve for any Notion workspace user; no plan requirement is stated, but public connections need Notion security review before Marketplace listing.
- 99%of agent runs complete successfully
- ~45 minon average to build your first agent
- 1M+back-office tasks completed
The connection is a project before it does anything.
Before the first record moves: an app registration, credentials, token refresh, and somewhere to host and monitor the code. Per-connection limit of 600 requests/min on Business/Enterprise and 180 requests/min on other plans, plus a shared per-workspace limit; payloads max 1000 blocks / 500KB.
Register an app, store Notion credentials, refresh tokens and code around the rate limits.
Connect your Notion account once. Caddi holds the connection.
The job doesn't stop at Notion.
An intake, a filing or a client update also runs through email, documents and the other systems your team works in. The Notion API only reaches Notion.
Each extra system is another API, another set of credentials, another integration to own.
One automation runs across every tool the job touches, each through its API.
Someone has to own the code.
API versions change, fields get added and your process moves. Not all block types are supported (e.g., form and button blocks return as 'unsupported'), and synced block content cannot be updated.
A developer patches and redeploys the integration each time.
The person who does the work updates it by showing or describing the change. Every automation is reviewed before it runs in production, and every run is logged.
What the Notion API gives you
- Type
- REST (JSON)
- Authentication
- Internal integration token, OAuth 2.0 (public connections), or personal access token
- Who can get access
- Self-serve for any Notion workspace user; no plan requirement is stated, but public connections need Notion security review before Marketplace listing.
- What it covers
- Pages, databases/data sources, blocks, users, comments, and file uploads.
- Limits
- Per-connection limit of 600 requests/min on Business/Enterprise and 180 requests/min on other plans, plus a shared per-workspace limit; payloads max 1000 blocks / 500KB.
- Worth knowing
- Not all block types are supported (e.g., form and button blocks return as 'unsupported'), and synced block content cannot be updated.
Official docs: developers.notion.com. Checked September 2026. Vendors change access terms, so confirm with Notion before you build.
When to build the Notion integration in-house
When you have engineers and the integration is your product, or you need one narrow sync between two systems and someone to own it. When the goal is getting Notion work off someone's desk, the build is the slow part, and Caddi does it for you.
What teams usually want the Notion API for
CRM ↔ Notion database sync
Caddi mirrors the right slice of CRM data into a Notion database and writes updates back to the source.
Meeting page generation
Before each meeting, Caddi creates the meeting page in Notion with the agenda, attendees, and linked context.
Approval write-back
When a Notion approval column is updated, Caddi writes the decision back to the source system and notifies the requester.
Everything Caddi does with Notion.
Notion API questions
Does Notion have an API?
Yes. Notion has a REST API, authenticated with Internal integration token, OAuth 2.0 (public connections), or personal access token. The official documentation is at https://developers.notion.com/.
How do I get access to the Notion API?
Self-serve for any Notion workspace user; no plan requirement is stated, but public connections need Notion security review before Marketplace listing.
Does the Notion API have rate limits?
Per-connection limit of 600 requests/min on Business/Enterprise and 180 requests/min on other plans, plus a shared per-workspace limit; payloads max 1000 blocks / 500KB.
Can I connect Notion to my other tools without writing code against its API?
Yes. With Caddi you show the Notion task once, the way you'd train a new hire, and Caddi builds it as verified code that runs across Notion and the other tools the job touches. Steps that need a person's judgment are handed to Copilot or Claude, and Caddi monitors those too.
Do I need a developer to automate Notion with Caddi?
No. There is no integration code for you to write or maintain. Every automation Caddi builds for Notion is reviewed before it runs in production, and every run is logged.