Skip to content
PostemiDocs
Sign inStart free
Platforms

WordPress: posting rules and settings

What a WordPress channel accepts in Postemi: media, limits, required fields, and the fields of the settings object for the API.

Beta

New in Postemi and not yet tested with many sites. Tell us if something does not work.

Basics

Platform
WordPress
Character limit
The platform does not specify a general limit.
Media
Only the featured image (main_image) is uploaded. Pictures attached to the post are not sent.
settings.__type
wordpress
Required fields
title, type
Platform page
WordPress scheduler

Rules

  • You connect with the site address, a username and an Application Password (WordPress 5.6 or newer, over https).
  • The post text is sent as HTML.
  • Beta: not yet tested with many sites.

Settings fields

These fields go into the post's settings object, alongside the __type field. In the UI, you fill in the same ones in the channel's settings section.

FieldTypeRequiredWhat it does
titlestringyesThe post title, at least 2 characters.
typestringyesThe REST base of the post type, for example "posts" or "pages" (the postTypes function lists them).
status"publish" | "draft" | "pending" | "private"noDefaults to "publish".
main_image{ id: string; path: string }noThe featured image, from your media library.
categoriesnumber[]noCategory ids (the categoriesList function lists them).
tagsnumber[]noTag ids (the tagsList function lists them).

Examples

Each example is one item in the POST /public/v1/posts request's posts array. The envelope around it is always this:

{
  "type": "schedule",
  "date": "2026-09-15T09:00:00.000Z",
  "shortLink": false,
  "posts": [ /* the item below */ ]
}
{
  "integration": { "id": "<channel-id>" },
  "value": [{ "content": "<p>The text of the post.</p>", "image": [] }],
  "settings": { "__type": "wordpress" }
}

The channel ID comes from the channel list, and the path values for images and videos from media upload. The exact schema for the connected account comes from the settings schema endpoint. From the command line, the same thing is the --settings flag. See the CLI examples.

Is something missing from this page? Email [email protected] or use the form on the Help page.