Notion APIConnect Notion without building on its API
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. If you're reading the docs because you need Notion to talk to the rest of your stack, Caddi does that without you writing or maintaining integration code: you show it the job once, and it runs it across Notion and your other tools.
- APIREST (JSON)
- AuthInternal integration token
- AccessSelf-serve
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.
Building on the Notion API vs. having Caddi run it
| The job | Build it on the API | With Caddi |
|---|---|---|
| Getting access | Register an app, get Notion credentials, and manage tokens and refreshes. | Connect your Notion account once. Caddi holds the connection. |
| Writing the integration | A developer maps fields, handles pagination, retries and rate limits, and writes the sync. | You show Caddi the Notion task the way you'd train a new hire. It writes verified code for it. |
| Steps the API doesn't cover | Screens with no endpoint stay manual, or need a separate RPA tool. | Caddi uses a secure, audited browser session where there's no API, in the same automation. |
| The other systems in the loop | Each extra tool is another API, another set of credentials, another integration to own. | One automation runs across all the tools the job touches. |
| Keeping it running | Someone owns the code when the API version, fields or your process change. | Every automation is reviewed before it runs in production, and every run is logged. |
Building on the API is the right call when you have engineers and the integration is your product. When the goal is getting Notion work off someone's desk, the build is the slow part.
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.
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. Where a step has no API, Caddi uses a secure, audited browser session in the same automation.
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.
Connect Notion without the build.
Drop your work email and pick a time. We'll show you Caddi running your Notion workflow end to end.