WordPress posting settings

Every post to WordPress carries a settings object with "__type": "wordpress", a title and a post type. Read the live schema for your channel with Get a channel’s settings. A WordPress channel connects with the site address, a username and an Application Password, which only the app’s connect form takes. Connect it in the app first, then post to it here.

Fields

Field	Type	Required	What it does
`__type`	string	No	Always `"wordpress"`. PostQueen sets it from the channel you post to, so it can be left out.
`title`	string	Yes	The post title, at least 2 characters. The slug is made from it.
`type`	string	Yes	The REST base of the post type: `posts` for posts, `pages` for pages, or a custom type’s base. The `postTypes` tool lists them. Not `post`.
`status`	string	No	`publish` (the default), `draft`, `pending` or `private`.
`categories`	number[]	No	Category ids from the `categoriesList` tool.
`tags`	number[]	No	Tag ids from the `tagsList` tool.
`main_image`	object	No	The featured image, `{ "id": "...", "path": "..." }` as upload a file returns it. It is uploaded to the site’s media library.

The body comes from value[0].content and is sent as HTML, so headings, bold, lists and links keep their tags. To show a picture inside the post, put <img src="..." alt="..."> in the content where it should appear, with the path of a picture in your media library. It is published with that address and is not uploaded to your site; a src that is not a PostQueen upload is dropped. Media in value[].image is not sent: besides those pictures, only main_image reaches WordPress. WordPress has no follow-ups, so entries after the first in value are not published.

Find post types, categories and tags

Three tools read them from the site. Call them through trigger a provider tool, with no data:

curl -X POST "https://api.postqueen.ai/public/v1/integration-trigger/YOUR_CHANNEL_ID" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"methodName": "postTypes", "data": {}}'

Tool	Answers	Use it for
`postTypes`	`[{ "id": "posts", "name": "Posts" }, ...]`	`type`: send the `id`
`categoriesList`	`[{ "id": 7, "name": "News" }, ...]`, the first 100	`categories`
`tagsList`	`[{ "id": 12, "name": "Release" }, ...]`, the first 100	`tags`

Each answer comes wrapped in { "output": ... }.

What PostQueen checks

A post that breaks one of these rules is refused with 400 before it is scheduled:

Rule	Message
A title of at least 2 characters	“title must be longer than or equal to 2 characters”
A post type	“type should not be null or undefined”
`status` is one of the four values	“status must be one of the following values: publish, draft, pending, private”
`categories` and `tags` hold numbers	“each value in categories must be a number conforming to the specified constraints”
The body within 100,000 characters	“post is too long, please fix it”

The settings rules come back as a list, with each field’s path:

{
  "statusCode": 400,
  "message": ["posts.0.settings.type should not be null or undefined", "posts.0.settings.type must be a string"],
  "error": "Bad Request"
}

The text limit comes back with the channel’s name instead, as on posting settings by network. A type your site does not have is not checked first: WordPress refuses the post when it is published. The featured image is held to your server’s upload limit.

Examples

Send each body to create a post. Replace YOUR_CHANNEL_ID with the channel’s id from list channels, the category and tag ids with values from the tools above, and the media id and path with the values upload a file returns.

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        {
          "content": "<p>Our autumn release is out.</p><h2>What changed</h2><ul><li>Faster search</li><li>A new dark theme</li></ul>",
          "image": []
        }
      ],
      "settings": {
        "__type": "wordpress",
        "title": "Our autumn release",
        "type": "posts",
        "status": "publish",
        "categories": [7],
        "tags": [12, 15],
        "main_image": { "id": "MEDIA_ID", "path": "https://uploads.postqueen.ai/autumn-release.png" }
      }
    }
  ]
}

{
  "type": "schedule",
  "date": "2026-10-01T09:00:00.000Z",
  "shortLink": false,
  "tags": [],
  "posts": [
    {
      "integration": { "id": "YOUR_CHANNEL_ID" },
      "value": [
        { "content": "<p>Everything you need to know before the event, updated weekly.</p>", "image": [] }
      ],
      "settings": {
        "__type": "wordpress",
        "title": "Event guide",
        "type": "pages",
        "status": "draft"
      }
    }
  ]
}

In the second example the page is created as a draft in WordPress at the scheduled time, ready for you to finish there.

Get started

Endpoints

Posting settings by network

Build on PostQueen

SDK and no-code

WordPress posting settings

Fields

Find post types, categories and tags

What PostQueen checks

Examples

​Fields

​Find post types, categories and tags

​What PostQueen checks

​Examples

​Related

Fields

Find post types, categories and tags

What PostQueen checks

Examples

Related