Skip to main content
Blog PostsVersion: v3

Create Blog Post

POST/blogs/posts

The "Create Blog Post" API allows you to create a blog post for any given blog site.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:blogs/post.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available optionsv3
Example:v3

Body

application/json
titlestring

Title of the blog post

Example:My Blog Post
locationIdstringrequired

Sub-account (location) identifier the blog post belongs to

Example:ve9EPM428h8vShlRW1KT
blogIdstringrequired

Identifier of the blog site the post belongs to

Example:lMOzIQZne5m6zQ528sT6
imageUrlstring

Cover image URL for the blog post

Example:https://storage.googleapis.com/blog-assets/posts/cover.png
descriptionstring

Short description or excerpt for the blog post

Example:A practical guide to inbound marketing in 2026.
rawHTMLstringrequired

Full HTML body of the blog post

Example:<h1>Hello</h1><p>This is my post.</p>
statusstringrequired

Publication status of the blog post

Available optionsDRAFTPUBLISHEDSCHEDULEDARCHIVEDDELETED
Example:DRAFT
wordCountnumber

Total word count of the blog post body

Example:1200
readTimeInMinutesnumber

Estimated read time of the blog post, in minutes

Example:6
archivedboolean

Whether the blog post is archived

Example:false
imageAltTextstring

Alt text for the cover image

Example:A laptop on a desk
currentVersionstring

Identifier of the current version of the blog post

Example:66c381b38be80858b9af62b7
metaDataobject

Metadata about actors that performed lifecycle actions on the post

categoriesstring[]

Identifiers of categories the blog post belongs to

Example:["659ecabc4a37969a2b7cc370"]
tagsstring[]

Tags applied to the blog post

Example:["marketing","seo"]
authorstring

Identifier of the author of the blog post

Example:659ec9634a3796e4e47cc360
urlSlugstring

URL-safe slug used in the blog post path

Example:my-blog-post
canonicalLinkstring

Canonical link override for SEO

Example:https://example.com/blog/my-blog-post
importIdstring

Identifier of the import record this post was created from

Example:64a1b2c3d4e5f6a7b8c9d0e1
typestring

Post type marker (e.g., "preview")

Example:preview
publishedAtstring

Timestamp when the post was (or will be) published

Example:2026-05-13T17:14:57.000Z

Response

application/json

Blog post created

dataobjectrequired

Object containing response data of blog post create