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"
}
}
API Reference
Append Prebuilt Blocks
Append already-converted Notion blocks directly to a page
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
Show data
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
afterparameter together with thelastBlockIdreturned from previous calls to chain precise insertions. - If you need help generating blocks, use the
/convertendpoint first and then pass the resulting array here.