Skip to main content

HTML blocks via the API

By Steven Van ·

You can now create HTML blocks with the API.

Notion's API can now create HTML blocks directly. Developers upload an .html file with the File Upload API, then attach it to an embed block using embed.file_upload when appending block children, creating a page, or updating a block.

The Notion app renders the file's contents interactively in a sandboxed iframe, the same HTML block the app creates with the /html command and that agents create through Notion MCP. Full details are in the changelog entry.

Notion
Notion
All-in-one workspace for notes, docs, projects, and wikis — with AI built in for writing, summarizing, and organizing.
View Notion →

Read the original announcement →

Read HTML blocks via the API on Creators Toolbox