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.

Billing: Request; paid actions are priced in credits (see GET /v1/messaging/prices) · Rate limit: 60/min

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

Request

  • Base URL: https://apihub.co.il
  • URL: https://apihub.co.il/v1/messaging/accounts/{accountId}/blogs/{blogId}/articles
  • Auth: HTTP bearer

Path parameters

blogIdstring required

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

accountIdstring required

Connected Shopify or WordPress account id.

Headers

Idempotency-Keystring

Replay-safe: the same execution is returned instead of charging twice

X-Tagstring

Group calls into one job (e.g. one video) — see GET /v1/usage?tag=…

Request body

tagsstring[]

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

titlestring required
authorstring

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

handlestring

URL slug. Generated from the title when omitted.

excerptstring

Short summary shown in blog listings.

bodyHtmlstring

Article body as HTML.

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

Completed

idstring

Execution id — stable across internal retries; use it with GET /v1/executions/{id}

status'pending' | 'processing' | 'completed' | 'partial' | 'failed' | 'cancelled' | 'timeout'
operationstring
tagstring nullable

Your X-Tag, if sent

created_atstring date-time
completed_atstring date-time nullable
errorstring nullable

Changes

No recorded changes to this operation across all 2 revisions of this API.