Quickstart

Get Your API Key

First, you’ll need to get your API key from the Mark2Notion dashboard.

Visit mark2notion.com and create an account.

Get API Key

Navigate to your dashboard and copy your API key.

Connect Notion (for page operations)

Click “Connect Notion” in your dashboard to authorize access to your workspace via OAuth. Required for /append, /append-blocks, /clear-page, and /notion-to-markdown.

Get the Page URL or ID

Pass a URL or page ID as the pageId parameter:

Full Notion page URL: https://notion.so/Your-Page-Title-abc123def456
Or just the page ID: abc123def456

Both formats are accepted — the API normalizes them automatically.

Using a Manual Notion Token (Advanced)

If you prefer not to use OAuth, you can pass a notionToken directly in each request instead.

Create a Notion Integration

Go to notion.so/my-integrations, click “New integration”, select your workspace, and copy the Internal Integration Token (starts with ntn_).

Share the Target Page

Open your Notion page, click the ··· menu → Connections → Add connection, then select your integration. Repeat for each page you want to access.

Pass the Token in Requests

Include notionToken in your request body alongside pageId. The OAuth connection is not needed when a token is provided directly.

Make Your First Request

Let’s convert some Markdown to Notion blocks:

curl -X POST "https://api.mark2notion.com/api/convert" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "markdown": "# Hello World\n\nThis is my **first** API call!"
  }'

const response = await fetch('https://api.mark2notion.com/api/convert', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    markdown: '# Hello World\n\nThis is my **first** API call!'
  })
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    'https://api.mark2notion.com/api/convert',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'markdown': '# Hello World\n\nThis is my **first** API call!'
    }
)

data = response.json()
print(data)

Try with Postman

Prefer using Postman? We’ve got you covered with a ready-to-use collection:

Fork the Collection

Visit our Postman collection on the Postman API Network and fork it to your workspace.

Watch for Updates

Click “Watch” on the collection to get notified when we add new endpoints and examples.

Configure Your API Key

Set your Mark2Notion API key in the collection’s environment variables.

Expected Response

{
  "status": "success",
  "data": {
    "blocks": [
      {
        "type": "heading_1",
        "heading_1": {
          "rich_text": [
            {
              "type": "text",
              "text": {
                "content": "Hello World"
              }
            }
          ]
        }
      },
      {
        "type": "paragraph",
        "paragraph": {
          "rich_text": [
            {
              "type": "text",
              "text": {
                "content": "This is my "
              }
            },
            {
              "type": "text",
              "text": {
                "content": "first"
              },
              "annotations": {
                "bold": true
              }
            },
            {
              "type": "text",
              "text": {
                "content": " API call!"
              }
            }
          ]
        }
      }
    ],
    "blockCount": 2
  }
}

Next Steps

Now that you’ve made your first request, you can:

Append to Notion

Learn how to append content directly to Notion pages.

Handle Errors

Understand error responses and how to handle them.

Authentication

Learn more about API authentication and rate limits.

Give Feedback

Share your experience and help us improve.

Getting Started

API Reference

Support

Legal

Get Your API Key

Get the Page URL or ID

Using a Manual Notion Token (Advanced)

Make Your First Request

Try with Postman

Expected Response

Next Steps

Append to Notion

Handle Errors

Authentication

Give Feedback

​Get Your API Key

​Get the Page URL or ID

​Using a Manual Notion Token (Advanced)

​Make Your First Request

​Try with Postman

​Expected Response

​Next Steps

Append to Notion

Handle Errors

Authentication

Give Feedback

Get Your API Key

Get the Page URL or ID

Using a Manual Notion Token (Advanced)

Make Your First Request

Try with Postman

Expected Response

Next Steps