Skip to content

content_posts_create

Create a post.

Tool

content_posts_create

Create a post.

Create a post. It starts as a draft at version 1; submit it for approval when the text is ready.

Behavior

HTTP
POST /content/posts

Arguments

NameTypeRequiredDescription
textstringThe post text, channel-independent, written in markdown — bold, italic, lists, links. Each network gets it flattened to the plain text that network accepts; content_publications_validate shows exactly what that looks like per channel. Per-channel variants come later, at publish time.
mediaarrayMedia references attached to the post, in display order. Opaque strings — the toolkit does not upload or resolve them.

Response

FieldTypeAlwaysDescription
idstringPost id.
textstringThe current text of the post, in markdown.
mediaarrayMedia references attached to the current version.
authorstringIdentity id of whoever composed the post.
statusstringPost lifecycle status: draft (being written) -> pending_approval (submitted) -> approved (cleared to publish); scheduled/published/failed are set by the publishing pipeline.
createdAtstringISO-8601 creation time.
updatedAtstringISO-8601 time of the last change.
currentVersionintegerVersion number of the current text.
approvedVersionintegerThe version an approval binds to, or null. Cleared on every edit: approving one text never covers another.

Try it

Create a post.

When to use

Create a post. It starts as a draft at version 1; submit it for approval when the text is ready.

Example

Ask your agent something like this:

Create a post.

The agent will invoke content_posts_create with these arguments:

{
  "text": "<text>"
}

Esc

Start typing to search the docs.

navigateselect