Zernio
Zernio
API Reference

Blogs

Blogs

List blogsGETCreate a blogPOSTGet a blogGETUpdate a blogPATCHDelete a blogDELETE

Articles

List blog articlesGETCreate a blog articlePOSTGet a blog articleGETUpdate a blog articlePATCHDelete a blog articleDELETE
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
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.

PlatformsShopify
POST
/v1/accounts/{accountId}/blogs/{blogId}/articles

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Path Parameters

accountId*string

Connected Shopify SocialAccount id.

blogId*string

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

Match^\d+$

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

{  "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"  }}
Was this page helpful?

List blog articles

Lists the articles of a blog. 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.

Get a blog article

Fetches a single article. An article addressed through a blog it does not belong to is a 404 (code blog_article_not_found). Supported on Shopify (platform `shopify`). Accounts on platforms without blogs support return 400; a blogs-capable platform that lacks this specific operation returns 405.

title*string
Length1 <= length
bodyHtml?string

Article body as HTML.

handle?string

URL slug. Generated from the title when omitted.

tags?array<string>
author?string

Display name of the article author.

excerpt?string

Short summary shown in blog listings.

image?

Featured image. The platform downloads it, so the URL must be publicly reachable.

seo?

Search-engine overrides. Maps to Shopify global metafields (title_tag and description_tag).

isPublished?boolean

Set false to create the article as a draft.

publishDate?string

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

Formatdate-time