Create a blog article
Creates an article on the blog. Publishing behavior:
isPublished: falsekeeps the article as a draft.- A future
publishDateschedules publication natively on the platform; the platform publishes it at that time with no Zernio queue involved. seo.title/seo.descriptionmap to Shopify's globaltitle_taganddescription_tagmetafields (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.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Connected Shopify SocialAccount id.
Platform-native numeric blog id. Non-numeric values return 400.
^\d+$1 <= lengthArticle body as HTML.
URL slug. Generated from the title when omitted.
Display name of the article author.
Short summary shown in blog listings.
Featured image. The platform downloads it, so the URL must be publicly reachable.
Search-engine overrides. Maps to Shopify global metafields (title_tag and description_tag).
Set false to create the article as a draft.
ISO 8601 datetime with offset (or Z). A future date schedules publication natively on the platform.
date-timeResponse Body
application/json
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.blogs.createBlogArticle({ path: { accountId: 'account_abc123', blogId: 'blog_abc123', }, body: { title: 'Example', },});console.log(data);{
"platform": "shopify",
"article": {
"id": "string",
"blogId": "string",
"platform": "shopify",
"title": "string",
"bodyHtml": "string",
"handle": "string",
"tags": [
"string"
],
"author": "string",
"excerpt": "string",
"image": {
"url": "string",
"altText": "string"
},
"isPublished": true,
"publishedAt": "2019-08-24T14:15:22Z",
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
}{
"error": "string",
"type": "invalid_request_error",
"code": "string",
"param": "string",
"platform": "string",
"platformError": {},
"details": {}
}{
"error": "Unauthorized"
}List blogs GET
Lists the blogs on the connected store, newest-first as the platform returns them. Cursor-paginated: pass `limit` (1-50, default 20) and the `cursor` from a previous response's `nextCursor`; `nextCursor` is null when there are no more pages. Supported on Shopify (platform `shopify`). Accounts on platforms without blogs support return 400; a blogs-capable platform that lacks this specific operation returns 405.
Create a blog POST
Creates a blog on the connected store. The platform generates the URL `handle` from the title when omitted. Supported on Shopify (platform `shopify`). Accounts on platforms without blogs support return 400; a blogs-capable platform that lacks this specific operation returns 405.