Create a post
Creates a post in an existing blog's Notion Content database. The post is marked ready to publish by default.
Requires a connected Notion account and an existing publication. Use
POST /v1/blog/create first if you haven't set up a blog yet. Make sure to select the appropriate scope when generating your API key.Body parameters
publication_id
ID of the Feather publication to create the post in.
title
Post title. Maps to the
Name property in the Notion Content database.slug
URL slug for the post. Used to construct the returned
post_url.excerpt
Short summary or teaser shown in post listings.
publish_date
ISO 8601 date string (e.g.
2026-05-12).ready_to_publish
Whether the post is ready to go live. Defaults to
true.featured
Mark the post as featured.
meta_title
SEO meta title override.
meta_description
SEO meta description override.
do_not_index
Exclude the post from search engine indexing.
hide_cta
Hide the call-to-action block on this post.
hide_in_main_feed
Hide the post from the main blog feed.
hide_cover
Hide the cover image on this post.
canonical_url
Canonical URL if this post is syndicated from another source.
extra_info
Free-form extra info field stored on the Notion page.
content
Post body as plain text. Appended as a paragraph block on the Notion page.
Error cases
validation_error
publication_id or title is missing or empty.notion_not_connected
Notion is not connected for this account. Open Feather, connect Notion under integration settings, then retry.
forbidden
The publication exists but belongs to a different account.
publication_not_found
No publication found for the given
publication_id.content_database_missing
The publication has no Content database configured. Ensure it was created via
POST /v1/blog/create.