Skip to main content
POST
Create Article

Create Article

Creates a new article in the specified blog.

Request

Path Parameters

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.
string
required
Internal article name
string
required
The article title
string
required
Article body content (HTML)
string
URL-safe handle. Provide one — if omitted, the handle is stored as null (there is no auto-slugify from the title).
array
Array of tag strings (e.g., ["summer", "sale", "featured"])
string
Featured image URL
string
Custom template suffix (e.g., featured for article.featured.liquid)
string
Custom page title for search engines
string
Meta description 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.
integer
HTTP status code (201 on success)
string
"success" or "error"
object
The created article object

Example Response

Error Codes

Errors return the same envelope with state: "error" and a message.