​
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.

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

​
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.