Notion Connector

Access the full Notion API through OAuth. Search pages, query databases, create content, and manage your workspace programmatically.

Pricing

Operation	Price
Successful API call (2xx)	$0.001
Failed call (4xx/5xx)	Free

Quick Test (curl)

# Search pages and databases
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"notion","endpoint":"/v1/search","method":"POST","body":{"query":"meeting notes"}}'

# Get current user
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"notion","endpoint":"/v1/users/me","method":"GET"}'

# Get a database
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"notion","endpoint":"/v1/databases/your-database-id","method":"GET"}'

# Create a page in a database
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer sk-your-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"notion","endpoint":"/v1/pages","method":"POST","body":{"parent":{"database_id":"your-db-id"},"properties":{"Name":{"title":[{"text":{"content":"New Page"}}]}}}}'

Request Format

POST /v1/run
{
  "model": "notion",
  "endpoint": "/v1/search",
  "method": "POST",
  "params": {},
  "headers": {},
  "body": {"query": "search term"},
  "retries": 0
}

Common Endpoints

Method	Endpoint	Description
POST	/v1/search	Search pages and databases
GET	/v1/users/me	Current user info
GET	/v1/databases/{id}	Get database schema
POST	/v1/databases/{id}/query	Query database rows
POST	/v1/pages	Create a page
PATCH	/v1/pages/{id}	Update page properties
GET	/v1/blocks/{id}/children	Get block children

📖 Full API reference: Notion API Reference

Technical Specs

Spec	Value
Auth	OAuth 2.0 (integration-level)
Proxy	Nango (auto token refresh)
Execution	Sync
Rate limit	Inherits Notion's 3 req/sec per integration