Blogs

Create a blog article

Changed on

Creates an article on the blog. Publishing behavior:

  • WordPress, Wix and Webflow default 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), and on Wix to the post's SEO title and meta description. WordPress and Webflow reject seo; SEO plugin and custom-field writes are not supported.
  • Webflow has no scheduling API: a future publishDate returns 400 unless isPublished: false keeps a draft. Fields map to the collection's own fields by type and slug (the body to its rich text field, excerpt to a summary field, image to an image field, tags and author to tag and author reference fields); sending a field the collection does not have returns 400, as does a collection that requires a field the Blogs API cannot fill.
  • Wix stores rich content: bodyHtml is converted on write (each top-level HTML element must fit 30,000 characters), and images in the body are imported into the site's Media Manager.

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

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

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/accounts/{accountId}/blogs/{blogId}/articles
  • Auth: HTTP bearer

Path parameters

accountIdstring required

Connected Shopify, WordPress, Wix or Webflow account id.

blogIdstring required

Platform-native 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 and Wix resolve existing names case-insensitively and create missing tags (Wix allows up to 30).

authorstring

Shopify author display name, numeric WordPress user id serialized as a string, or Wix site member id. Assigning another WordPress user may require elevated capability. Wix posts without one go to the site's default author.

excerptstring

Short summary shown in blog listings.

isPublishedboolean

Set false for a draft or true to publish. On WordPress and Wix 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.

fieldDataobject

Webflow only. The collection's own fields that the Blogs API does not map, keyed by field slug, in Webflow's value format (a Reference is an item id, an Image is { url, alt }). Required by collections with required fields of their own; a create that leaves one empty answers 400 listing them. A slug the API already fills (name, slug, body, summary, image, tags, author, date) or one the collection lacks answers 400. Other platforms answer 400.

Response

Article created

platform'shopify' | 'wordpress' | 'wix' | 'webflow'

Changes

  • 5304778ae6b6Revision changes
    • warning

      added the new webflow enum value to the / response property for the response status

    • warning

      added the new webflow enum value to the response property for the response status

    • info

      added the new optional request property

  • 0d064f3b2f7aRevision changes
    • warning

      changed the pattern of the path request parameter blogId from ^\d+$ to ^[A-Za-z0-9_-]{1,64}$

    • warning

      added the new wix enum value to the / response property for the response status

    • warning

      added the new wix enum value to the response property for the response status