Skip to main content

​
Get Your API Key

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

Sign Up

Visit mark2notion.com and create an account.
2

Get API Key

Navigate to your dashboard and copy your API key.
3

Set Up Notion Integration

Create a Notion integration and get your Notion token from notion.so/my-integrations.Need help with Notion? Follow this guide: Getting started with the Notion API.

​
Notion Setup

  1. Create a Notion Integration
  2. Share Your Notion Page with the Integration
    • Open your target Notion page
    • Click the three dots (•••) in the top right corner
    • Select “Connections” → “Add connection”
    • Find and select your integration from the list
  3. Get the Page ID
    • From the page URL: notion.so/page-name-PAGE_ID
    • Or from the “Copy link” option

​
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!"
  }'

​
Try with Postman

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

Fork the Collection

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

Watch for Updates

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

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.