Skip to content

Developer platforms · openapi

Notion API Mock Server

Workspace + database API

A stateful mock of the Notion API for docs and workspace tools. Create pages, query databases, append blocks — Carbon replays the exact shape of Notion responses without needing a real workspace token.

Quickstart

npx carbon-api emulate --catalog notion

Runs on http://localhost:8787 by default. No account, no signup.

Try it

Real HTTP against the local replica.

Create a page

curl -X POST http://localhost:8787/pages \
  -H 'content-type: application/json' \
  -d '{"name":"example"}'

List them back (state persists)

curl http://localhost:8787/pages

What's covered

Carbon compiles the entire spec — these are just the resources most integrations reach for first.

  • pages
  • databases
  • blocks
  • users

Under the hood

Everything Carbon gives you comes with this emulator — for free.

  • · Stateful CRUD — writes persist across requests.
  • · Snapshots — freeze and restore the whole world with one command.
  • · Chaos presets — inject latency, 5xx, and network errors on demand.
  • · Deterministic — the same requests produce the same responses in CI.