Back to Help Center

API & Integration

Integrate Notion Embed with your applications using our powerful REST API and webhooks.

API Authentication

Securely authenticate your API requests to Notion Embed.

Steps

  1. Navigate to Settings > API Keys in your dashboard
  2. Click "Generate New API Key"
  3. Copy and securely store your API key
  4. Include the key in your request headers
  5. Use Bearer token authentication

Generating Embeds via API

Programmatically create and manage embeds using our REST API.

Steps

  1. Make a POST request to /api/v1/embeds
  2. Include your Notion page URL in the body
  3. Specify embed options (dimensions, theme, etc.)
  4. Receive embed code and URL in response
  5. Use the returned snippet in your application

Webhook Configuration

Receive real-time notifications when your embeds update.

Steps

  1. Go to Settings > Webhooks
  2. Add your webhook endpoint URL
  3. Select events to subscribe to
  4. Verify webhook with test payload
  5. Handle incoming webhook events in your app

Rate Limits & Quotas

Understand API rate limits and how to work within them.

Steps

  1. Starter: 100 requests/hour
  2. Pro: 1,000 requests/hour
  3. Enterprise: 10,000 requests/hour
  4. Check X-RateLimit headers in responses
  5. Implement exponential backoff for retries

Example API Request

curl -X POST https://api.notionembed.com/v1/embeds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "notion_url": "https://notion.so/your-page",
    "options": {
      "theme": "auto",
      "show_toc": true
    }
  }'

Full API Documentation

Read: Notion Embed API Developer Guide →