Sign in
Blogs

Create a blog article

Creates an article on the blog. Publishing behavior:

  • isPublished: false keeps the article as a draft.
  • A future publishDate schedules publication natively on the platform; the platform publishes it at that time with no Zernio queue involved.
  • 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).

Supported on Shopify (platform shopify). Accounts on platforms without blogs support return 400; a blogs-capable platform that lacks this specific operation returns 405.

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

Path parameters

accountIdstring required

Connected Shopify SocialAccount id.

blogIdstring required

Platform-native numeric blog id. Non-numeric values return 400.

Request body

titlestring required
bodyHtmlstring

Article body as HTML.

handlestring

URL slug. Generated from the title when omitted.

tagsstring[]
authorstring

Display name of the article author.

excerptstring

Short summary shown in blog listings.

isPublishedboolean

Set false to create the article as a 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'