Publish a WordPress blog post
post_to_wordpressPublish, draft, or schedule a WordPress blog post from a title and body, including featured or inline images, video, categories, and tags.
Instructions
Use this when the user wants to publish, draft or schedule a BLOG POST on their WordPress site. Publishing costs no credits. A title is REQUIRED and the text becomes the body: plain text or light markdown (## headings, - lists, bold, links) is turned into WordPress blocks, and HTML is sent as written. status: publish (default), draft, pending (submit for review), private (logged-in editors only) or future with a date — a future date makes WordPress schedule it natively. The FIRST image becomes the FEATURED image, every other image is uploaded and placed inline, and a video is uploaded and embedded (if the site's host refuses the file as too large, the post plays it from its own link and the reply says so). categories and tags take names or ids; a name the site lacks is CREATED and the reply says which. An over-long title is refused, never cut. WordPress has NO per-post views in its API: never quote a view count for a WordPress post. Works on a self-hosted site and on a site hosted on WordPress.com, whichever the brand connected. Not connected: the user connects it under Connectors > WordPress, or you call connect_connector with provider wordpress (siteUrl, username, appPassword).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>"
},
"name": "post_to_wordpress"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | ISO time to publish at; a future date schedules it on WordPress itself | |
| hook | No | the post's angle — a list_hooks id or your own wording, reused exactly | |
| slug | No | the end of the post URL | |
| tags | No | tag names or ids (a missing name is created) | |
| text | No | the body: plain text, light markdown or HTML | |
| brand | No | WHICH PROFILE this post belongs to — id or exact name from list_brands (a shared workspace: its profile id). Beats the connection's pin for THIS CALL ONLY; a name that matches no profile, or two, is REFUSED and nothing is posted. | |
| title | Yes | REQUIRED — the post title | |
| ideaId | No | short id of the content-plan idea this post came from | |
| recipe | No | the post's FORMAT id, e.g. "slideshow" or "imessage_chat" — post_performance groups by it, so reuse one id per format | |
| status | No | default publish | |
| altText | No | alt text for the images | |
| excerpt | No | the summary under the title in lists and search | |
| subject | No | what the post is about | |
| imageUrl | No | one image — becomes the featured image | |
| videoUrl | No | one video, embedded in the post | |
| imageUrls | No | several images: the first is featured, the rest go inline | |
| categories | No | category names or ids (a missing name is created) | |
| allowDuplicate | No | post it even though an identical post was just made | |
| idempotencyKey | No | any stable string: a repeat within 24h returns the original post instead of posting again |