https://demo.notifuse.com/api/blogPosts.create Creates a post as a draft. The post holds the metadata; its body lives in a web template, so publishing a post over the API takes three calls:
templates.createwithchannel: "web",category: "blog"and awebobject.web.htmlis the body readers see, rendered as-is.web.contentis required and is the Tiptap document the console editor opens; if you only have HTML, send{"type": "doc", "content": []}, and do not edit that post in the console afterwards, because saving there regeneratesweb.htmlfromweb.content.blogPosts.createwith that template'sidastemplate_id.blogPosts.publish.
Requires the blog write permission, plus the templates write permission for step 1.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your API key.
Query Parameters
The ID of the workspace. Passed in the query string, not the body.
Body application/json
An existing category.
Lowercase letters, digits and single hyphens. Must be unique across the whole workspace, not just within the category.
A web template (channel: web) holding the post body — create it first with templates.create. Its existence is not checked here: a post pointing at a missing template is saved and renders with an empty body.
The template version to render. Omit it (or send 0) to always render the template's latest version; pin a version to control exactly when a template edit reaches readers.
Show 2 child attributes Hide 2 child attributes
Search and social metadata for the page, exposed to the blog theme.
Show 8 child attributes Hide 8 child attributes
Open Graph title
Open Graph description
Open Graph image URL
Content of the robots meta tag.
Response
201 Post created as a draft object
Show 7 child attributes Hide 7 child attributes
Server-generated UUID.
The post's path segment on the blog (/{category_slug}/{post_slug}).
Show 7 child attributes Hide 7 child attributes
The post's H1.
The web template holding the post body.
Show 2 child attributes Hide 2 child attributes
The template version the post renders. 0 means the latest version, whatever it is at render time.
Show 2 child attributes Hide 2 child attributes
Displayed as given; not computed from the body.
Search and social metadata for the page, exposed to the blog theme.
Show 8 child attributes Hide 8 child attributes
Open Graph title
Open Graph description
Open Graph image URL
Content of the robots meta tag.
Absent while the post is a draft.
400 Bad request - validation failed, slug taken or category not found object
Error message
401 Unauthorized - invalid or missing authentication token object
Error message
403 Forbidden - missing the blog write permission object
Error message
The permission resource the endpoint requires.
The access level the endpoint requires on that resource.