Append Prebuilt Blocks

curl --request POST \
  --url https://api.mark2notion.com/api/append-blocks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "blocks": [
    {}
  ],
  "notionToken": "<string>",
  "pageId": "<string>",
  "after": "<string>"
}
'

import requests

url = "https://api.mark2notion.com/api/append-blocks"

payload = {
    "blocks": [{}],
    "notionToken": "<string>",
    "pageId": "<string>",
    "after": "<string>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({blocks: [{}], notionToken: '<string>', pageId: '<string>', after: '<string>'})
};

fetch('https://api.mark2notion.com/api/append-blocks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mark2notion.com/api/append-blocks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'blocks' => [
        [
                
        ]
    ],
    'notionToken' => '<string>',
    'pageId' => '<string>',
    'after' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mark2notion.com/api/append-blocks"

	payload := strings.NewReader("{\n  \"blocks\": [\n    {}\n  ],\n  \"notionToken\": \"<string>\",\n  \"pageId\": \"<string>\",\n  \"after\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mark2notion.com/api/append-blocks")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"blocks\": [\n    {}\n  ],\n  \"notionToken\": \"<string>\",\n  \"pageId\": \"<string>\",\n  \"after\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mark2notion.com/api/append-blocks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"blocks\": [\n    {}\n  ],\n  \"notionToken\": \"<string>\",\n  \"pageId\": \"<string>\",\n  \"after\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "totalBlocks": 2,
    "requestCount": 1,
    "retryCount": 0,
    "lastBlockId": "f9e8d7c6-b5a4-3210-9876-543210fedcba"
  }
}

{
  "status": "fail",
  "data": {
    "blocks": "Blocks must be a non-empty array"
  }
}

POST

api

append-blocks

Append Prebuilt Blocks

curl --request POST \
  --url https://api.mark2notion.com/api/append-blocks \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "blocks": [
    {}
  ],
  "notionToken": "<string>",
  "pageId": "<string>",
  "after": "<string>"
}
'

import requests

url = "https://api.mark2notion.com/api/append-blocks"

payload = {
    "blocks": [{}],
    "notionToken": "<string>",
    "pageId": "<string>",
    "after": "<string>"
}
headers = {
    "x-api-key": "<x-api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<x-api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({blocks: [{}], notionToken: '<string>', pageId: '<string>', after: '<string>'})
};

fetch('https://api.mark2notion.com/api/append-blocks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mark2notion.com/api/append-blocks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'blocks' => [
        [
                
        ]
    ],
    'notionToken' => '<string>',
    'pageId' => '<string>',
    'after' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mark2notion.com/api/append-blocks"

	payload := strings.NewReader("{\n  \"blocks\": [\n    {}\n  ],\n  \"notionToken\": \"<string>\",\n  \"pageId\": \"<string>\",\n  \"after\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.mark2notion.com/api/append-blocks")
  .header("x-api-key", "<x-api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"blocks\": [\n    {}\n  ],\n  \"notionToken\": \"<string>\",\n  \"pageId\": \"<string>\",\n  \"after\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mark2notion.com/api/append-blocks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<x-api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"blocks\": [\n    {}\n  ],\n  \"notionToken\": \"<string>\",\n  \"pageId\": \"<string>\",\n  \"after\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "data": {
    "totalBlocks": 2,
    "requestCount": 1,
    "retryCount": 0,
    "lastBlockId": "f9e8d7c6-b5a4-3210-9876-543210fedcba"
  }
}

{
  "status": "fail",
  "data": {
    "blocks": "Blocks must be a non-empty array"
  }
}

Overview

Use the append-blocks endpoint when you already have an array of Notion block objects and simply need them inserted into a page. This endpoint skips Markdown conversion and feeds your blocks through the same intelligent planning, batching, and retry logic used by the Markdown append workflow.

Request

string

required

Your Mark2Notion API key

array

required

Array of Notion block objects you want to append. Each block must follow the structure expected by the Notion API, including nested children when needed.

string

Your Notion integration token. Optional when your workspace is connected via OAuth in the dashboard. Pass this if you prefer to authenticate with a manual integration token instead. See Using a Manual Notion Token.

string

required

The URL or page ID of the Notion page to append blocks to. Pass the full notion.so page URL or just the page ID — both are accepted.

string

Optional block ID to append content after. If omitted, blocks are appended to the end of the page.

Response

string

Will be “success” for successful requests

object

Show data

number

Total number of blocks that were appended

number

Number of internal Notion API requests made (for transparency - does NOT affect your usage quota)

number

Number of retry attempts caused by rate limiting

string

ID of the last block that was created (use this for subsequent after appends)

Examples

curl -X POST "https://api.mark2notion.com/api/append-blocks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "blocks": [
      {
        "object": "block",
        "type": "paragraph",
        "paragraph": {
          "rich_text": [
            {
              "type": "text",
              "text": { "content": "First paragraph from raw blocks" }
            }
          ]
        }
      },
      {
        "object": "block",
        "type": "paragraph",
        "paragraph": {
          "rich_text": [
            {
              "type": "text",
              "text": { "content": "Second paragraph" }
            }
          ]
        }
      }
    ],
    "pageId": "https://notion.so/Your-Page-Title-a1b2c3d4e5f67890abcdef1234567890"
  }'

const blocks = [
  {
    object: 'block',
    type: 'paragraph',
    paragraph: {
      rich_text: [
        {
          type: 'text',
          text: { content: 'First paragraph from raw blocks' }
        }
      ]
    }
  },
  {
    object: 'block',
    type: 'paragraph',
    paragraph: {
      rich_text: [
        {
          type: 'text',
          text: { content: 'Second paragraph' }
        }
      ]
    }
  }
];

const response = await fetch('https://api.mark2notion.com/api/append-blocks', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY'
  },
  body: JSON.stringify({
    blocks,
    pageId: 'https://notion.so/Your-Page-Title-a1b2c3d4e5f67890abcdef1234567890'
  })
});

const data = await response.json();
console.log(`Added ${data.data.totalBlocks} blocks`);

import requests

blocks = [
    {
        "object": "block",
        "type": "paragraph",
        "paragraph": {
            "rich_text": [
                {
                    "type": "text",
                    "text": {"content": "First paragraph from raw blocks"}
                }
            ]
        }
    }
]

response = requests.post(
    'https://api.mark2notion.com/api/append-blocks',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'YOUR_API_KEY'
    },
    json={
        'blocks': blocks,
        'pageId': 'https://notion.so/Your-Page-Title-a1b2c3d4e5f67890abcdef1234567890'
    }
)

data = response.json()
print(f"Added {data['data']['totalBlocks']} blocks")

{
  "status": "success",
  "data": {
    "totalBlocks": 2,
    "requestCount": 1,
    "retryCount": 0,
    "lastBlockId": "f9e8d7c6-b5a4-3210-9876-543210fedcba"
  }
}

{
  "status": "fail",
  "data": {
    "blocks": "Blocks must be a non-empty array"
  }
}

Usage Notes

Provide blocks exactly as expected by the Notion API. Complex structures (tables, synced blocks, nested children) are supported as long as the JSON matches Notion’s schema.
The endpoint enforces non-empty arrays and idempotency, so repeated requests with the same blocks are safely deduplicated.
Use the after parameter together with the lastBlockId returned from previous calls to chain precise insertions.
If you need help generating blocks, use the /convert endpoint first and then pass the resulting array here.

Append to Notion Page Clear Notion Page

Getting Started

API Reference

Support

Legal

Append Prebuilt Blocks

Overview

Request

Response

Examples

Usage Notes

​Overview

​Request

​Response

​Examples

​Usage Notes

Overview

Request

Response

Examples

Usage Notes