# HTML blocks via the API

By Steven Van · 2026-07-03

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](<https://creatorstoolbox.com/tools/notion>) MCP. Full details are in the [changelog entry](<https://developers.notion.com/page/changelog#july-3-2026>).

[![](<https://notion-demo.mintlify.app/images/og-image.png>)](<https://developers.notion.com/page/changelog#july-3-2026>)

![Notion](<https://www.google.com/s2/favicons?domain=notion.so&sz=128>)

Notion

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

[View Notion →](<https://creatorstoolbox.com/tools/notion>)

Sources

[Original source](<https://developers.notion.com/page/changelog#july-3-2026>)

[Read HTML blocks via the API on Creators Toolbox](<https://creatorstoolbox.com/blog/notion-html-blocks-via-the-api>)

---
Canonical source: https://creatorstoolbox.com/blog/notion-html-blocks-via-the-api