Sign in
Blogs

Create a blog article

Creates an article on the blog. Publishing behavior:

  • WordPress defaults to a draft when both publishing fields are omitted.
  • isPublished: false keeps the article as a draft and takes priority over a future publishDate.
  • A future publishDate schedules publication natively on the platform; the platform publishes it at that time with no Zernio queue involved.
  • isPublished: true publishes immediately when there is no future publishDate.
  • seo.title / seo.description map to Shopify's global title_tag and description_tag metafields (the fields Shopify themes read for the page title and meta description). WordPress rejects seo; SEO plugin and custom-field writes are not supported.

Supported on Shopify (shopify) and WordPress (wordpress). WordPress native scheduling depends on the site's scheduler/WP-Cron.

post/v1/accounts/{accountId}/blogs/{blogId}/articles

Path parameters

accountIdstring required

Connected Shopify or WordPress account id.

blogIdstring required

Platform-native numeric blog/site id returned by the list operation.

Request body

titlestring required
bodyHtmlstring

Article body as HTML.

handlestring

URL slug. Generated from the title when omitted.

tagsstring[]

Tag names. WordPress resolves existing names case-insensitively and creates missing tags.

authorstring

Shopify author display name, or numeric WordPress user id serialized as a string. Assigning another WordPress user may require elevated capability.

excerptstring

Short summary shown in blog listings.

isPublishedboolean

Set false for a draft or true to publish. On WordPress false takes priority over a future publishDate; omission with no date defaults to draft.

publishDatestring date-time

ISO 8601 datetime with offset (or Z). A future date schedules publication natively on the platform.

Response

Article created

platform'shopify' | 'wordpress'

Changes