Skip to content

WordPress settings

Field Required Description
title Yes The post title. At least two characters.
type Yes The post type’s REST base, such as posts or pages (the id the post-types tool returns). Sharek publishes to /wp-json/wp/v2/<type>, so post or page fails.
main_image No Featured image, as a media object with id and path.
categories No Array of category ids as numbers.
tags No Array of tag ids as numbers.
status No publish, draft, pending or private.
"settings": {
"title": "What we learned shipping in public",
"type": "posts",
"main_image": {
"id": "media-id",
"path": "https://media.example.com/cover.png"
},
"categories": [12, 34],
"tags": [56, 78],
"status": "publish"
}
  • categories and tags are numeric ids, not names. Strings are refused.
  • Unlike the other blogging providers, WordPress tags are a flat array of numbers rather than objects.
  • Write the post body as HTML in the post’s content.
  • Pictures go inside the body as <img src="...">, where you want them to appear. Each src must be a picture from your media library, so upload it first with upload a file.
  • Attachments in the post’s value[].image are not published. The featured image comes only from main_image.
  • WordPress channels are connected with a site domain, a username and an application password that you supply. Use an application password rather than your account password.

Send these under settings in create a post. Read a channel’s live schema with channel settings. Connect the channel first: connecting your channels.