Function append

Example

// Using with Notion SDK client
const notion = new Client({ auth: NOTION_TOKEN });
const childBlocks = createNotion().paragraph("A paragraph").build()

const { apiResponses, apiCallCount } = await request.blocks.children.append({
  block_id: 'your-block-id',
  children: childBlocks.content,
  client: notion
});

// Using with custom API call function (using ky)
import ky from 'ky';

const NOTION_TOKEN = 'your-notion-token';

const apiCall = async ({ type, data }) => {
  const { block_id, children, after } = data;
  const response = await ky.patch(
    `https://api.notion.com/v1/blocks/${block_id}/children`,
    {
      json: { children, ...(after && { after }) },
      headers: {
        'Authorization': `Bearer ${NOTION_TOKEN}`,
        'Notion-Version': '2025-09-03',
      },
    }
  ).json();
  return response;
};

const childBlocks = createNotion().paragraph("Hello, World!").build();

const { apiResponses, apiCallCount } = await request.blocks.children.append({
  block_id: 'your-block-id',
  children: childBlocks.content,
  apiCall
});
Copy