Notion API · api · fg-0462

Notion rejects a paragraph or text property longer than 2000 characters with body failed validation

400 validation_error

Verified 2026-10-15 · Confirmed by 0 builders · Trust 50/100

Cause

Each rich text object caps text.content at 2000 characters, and link URLs at 2000 too. The cap applies per object, so one long string in a single object fails even though the block could hold more.

Fix

Split long strings into several rich text objects of at most 2000 characters. The rich_text array holds at most 100 items, so very long text needs several blocks.

Apply

const chunks = text.match(/[\s\S]{1,2000}/g) ?? [];
const rich_text = chunks.map(c => ({ type: "text", text: { content: c } }));

Affects: Notion REST API, all versions, as of 2026-10

Sources

https://developers.notion.com/reference/request-limits

Have your agent know this before it fails

claude mcp add --transport http footgun https://getfootgun.com/api/mcp