Troubleshooting

Content creation Failed. Fix the following:
Number of cells in table row must match the table width of the parent table

<!-- ❌ Bad: Inconsistent columns -->
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| A        | B        | C        |
| D        | E        |          <!-- Missing cell -->
| F        | G        | H        | I | <!-- Extra cell -->

<!-- ✅ Good: All rows have 3 columns -->
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| A        | B        | C        |
| D        | E        | F        |
| G        | H        | I        |

<!-- Empty cells must still be included -->
| Name     | Email            | Phone |
|----------|------------------|-------|
| John     | [email protected] | 555-1234 |
| Jane     | [email protected] |       |  <!-- Empty cell, but separator present -->

path failed validation: path.page_id should be a valid uuid,
instead was "1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p"

https://notion.so/My-Page-1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p
                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                              This is the page ID (32 chars, no hyphens)

Could not find page with ID: 12345678-1234-1234-1234-123456789abc.
Make sure the relevant pages and databases are shared with your integration.

Provided ID abcd1234-5678-90ef-abcd-ef1234567890 is a block, not a page.
Use the retrieve block API instead

// Page URL - use this ID for pageId parameter
https://notion.so/My-Page-abcd12345678901234567890abcdef123456

// Block URL (notice the #) - use page ID for pageId, block ID for "after"
https://notion.so/My-Page-abcd12345678901234567890abcdef123456#block123...

Provided ID aaaa1111-2222-3333-4444-bbbbccccdddd is a database, not a page.
Use the retrieve database API instead.

Can't edit block that is archived. You must unarchive the block before editing.

body failed validation: body.children[0].paragraph.rich_text.length should be ≤ 100,
instead was 107

body failed validation: body.children[0].paragraph.rich_text[0].text.content.length
should be ≤ 2000, instead was 8039

{"markdown": "Markdown is required"}
{"pageId": "Page ID is required"}
{"notionToken": "Notion token is required"}
{"blocks": "Blocks must be a non-empty array"}

{"markdown": "Markdown cannot be empty"}
{"markdown": "No blocks generated from markdown"}

Invalid JSON
Failed to parse request JSON. Bad control character in string literal...
Expected double-quoted property name in JSON at position X
Unexpected token 'm', "markdown=%"... is not valid JSON

// ✅ Good: Properly escaped
const body = JSON.stringify({
  markdown: "Line 1\nLine 2\n\"Quoted\"",
  pageId: "2c785200-4c6e-8182-ab77-dbbadb4daed6"
});

// ❌ Bad: Literal newlines and quotes
const body = '{
  "markdown": "Line 1
  Line 2
  "Quoted"",
  "pageId": "xxx"
}';

fetch('/api/append', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',  // Important!
    'x-api-key': 'your-api-key'
  },
  body: JSON.stringify({
    markdown: content,
    pageId: pageId,
    notionToken: token
  })
});

// ❌ Bad: Form-encoded
const body = 'markdown=' + encodeURIComponent(content);

// ✅ Good: JSON
const body = JSON.stringify({ markdown: content });

// All special characters are automatically escaped by JSON.stringify
const markdown = `Content with "quotes", newlines\n, and \\ backslashes`;
const body = JSON.stringify({ markdown }); // Handles escaping

API token is invalid.

Usage quota exceeded for current billing period

No usage counter found for current period

Conflict occurred while saving. Please try again.

Request to Notion API has timed out