Posts

Create post

Create a new blog post. collection_id is optional; when omitted, the blog's empty-slug default Posts collection is used. If that default does not exist, collection_id is required.

post/blogs/{blogId}/posts

Request

  • Base URL: https://api-docs.justblogged.com/api
  • URL: https://api-docs.justblogged.com/api/blogs/{blogId}/posts
  • Auth: HTTP bearer

Path parameters

blogIdstring required

Blog ID

Request body

titlestring required
slugstring nullable

Auto-generated from title if not provided

contentstring required
status'draft' | 'published'
collection_idstring

Optional collection ID. When omitted, the blog's empty-slug default Posts collection is used. If that default does not exist, collection_id is required.

author_idstring

Optional author user ID. Assigning another blog member requires owner or admin access.

imagestring nullable
published_atstring date-time nullable

Auto-set to now if status is published and not provided

tagsstring[]

Response

Created post

idstring required
titlestring required
urlstring uri required
slugstring required
contentstring required

HTML content

excerptstring required

Auto-generated excerpt from content or metadata.description

imagestring uri nullable
status'draft' | 'published' | 'scheduled' required

scheduled is derived from published status with future published_at

published_atstring date-time nullable
updated_atstring date-time nullable
created_atstring date-time required
metadataobject required

Custom metadata fields (max 20 fields)

Changes

No recorded changes to this operation across all 1 revision of this API.