# Headless blog, API and webhooks

> Write in our editor and show posts on your own site through the REST API, with signed webhooks to rebuild pages and a Next.js example to start.

URL: https://office.greatwork.company/publish/features/headless-blog
Last updated: 2026-11-21

Write and send here, display posts on your own website through the API. Signed webhooks tell your site when something changes.

## Headless mode

Turn on headless mode and enter your blog's URL. Canonical links, email links and View in browser links all point at your site. Your site pulls posts with an API key; the newsletter, subscribers and paid access still run here. There's a [Next.js](https://nextjs.org) example in the docs that fetches posts and rebuilds a page when a post is published.

## The API

A REST API with read and write keys: list and get posts (with HTML or markdown), post slugs, authors and tags; create a draft from markdown or HTML; add, list and remove subscribers. Every post also has a markdown version at its URL with `.md` on the end.

## Webhooks

Signed webhooks for post published, updated and unpublished; subscriber created, unsubscribed, upgraded and downgraded; send completed; comment created; and import finished. Failed deliveries retry, and you can see each request and redeliver it. Zapier, Make and n8n connect through these.

## Example: A marketing site that shows the blog

A design agency's website is a Next.js app. Their writers use Publish; the site fetches posts with a read key at build time, and a `post.published` webhook calls their revalidate endpoint so a new post is live on `agency.example.com/journal` within seconds. A second webhook, `subscriber.created`, adds every new subscriber to their CRM.

## How to set it up

1. Create an API key in **Settings > Integrations**.
2. Turn on headless mode and enter your blog's URL.
3. Add a webhook for `post.published` pointing at your site's rebuild endpoint.

## Questions

### Is there an MCP server for AI assistants?

An MCP server so an assistant can draft and schedule posts is coming soon. The REST API works today.

### Is the API on every plan?

Yes. Every feature is on every plan.

---

Office by Great Work. Questions or corrections: hello@greatwork.company
