Skip to main content
POST
Create Article

Create Article

Creates a new article in the specified blog.

Request

Path Parameters

blog_id
string
required
The unique blog ID to create the article in

Body Parameters

Fields may be sent at the top level, or nested under an article object.
name
string
required
Internal article name
title
string
required
The article title
content
string
required
Article body content (HTML)
handle
string
URL-safe handle. Auto-generated from the title if not provided.
tags
array
Array of tag strings (e.g., ["summer", "sale", "featured"])
image
string
Featured image URL
template_suffix
string
Custom template suffix (e.g., featured for article.featured.liquid)
seo_title
string
Custom page title for search engines
seo_desc
string
Meta description for search engines
seo_image
string
Social/share image URL for search engines

Response

The response uses the standard { status, state, message, data } envelope. On success state is "success" and the created article is returned under data.article.
status
integer
HTTP status code (201 on success)
state
string
"success" or "error"
data.article
object
The created article object

Example Response

Error Codes

Errors return the same envelope with state: "error" and a message.
StatusmessageWhen
400Missing required fields: name, title, contentA required field is missing or blank
401Invalid or missing access token
403App doesn’t have the write_content scope
500error detailUnexpected server error