Sign in
posts

Create a new post

Create a new post in your publication. The publication is identified by the API key provided in the Authorization header.

Requirements:

  • markdown field is required and will be converted to TipTap JSON format
  • title field is required

Behavior:

  • The post will be created as published by default
  • If sendNewsletter is true, an email will be sent to all subscribers
post/v1/posts

Request body

markdownstring required

Post content in Markdown format

titlestring required

Title of the post

subtitlestring

Optional subtitle or brief summary

imageUrlstring uri

Optional URL to the post's cover image

sendNewsletterboolean

Whether to send an email newsletter to subscribers. Default: false

slugstring

Optional URL-friendly identifier for the post. If not provided, will be generated from title

postPreviewstring

Optional preview text for the post. If not provided, will be generated from content

categoriesstring[]

Optional array of category tags for the post

Response

Post created successfully

idstring required

The ID of the created post

Changes