posts

POST /v3/blogs/{blogId}/posts

Changed on Oct 10, 2026

Inserts a post.

Request

Base URL
https://blogger.googleapis.com
Auth
OAuth 2 and OAuth 2
Implicithttps://accounts.google.com/o/oauth2/auth
Scopeshttps://www.googleapis.com/auth/blogger
Authorization codehttps://accounts.google.com/o/oauth2/auth
Token URLhttps://accounts.google.com/o/oauth2/token
Scopeshttps://www.googleapis.com/auth/blogger
TypeScript
https://skmtc.dev/google/apis/blogger/docs/v3/blogs/:blogId/posts/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

blogIdstring required

Query parameters

fetchBodyboolean

fetchImagesboolean

isDraftboolean

Request body

contentstring

The content of the Post. May contain HTML markup.

customMetaDatastring

The JSON meta-data for the Post.

etagstring

Etag of the resource.

idstring

The identifier of this Post.

kindstring

The kind of this entity. Always blogger#post.

labelsstring[]

The list of labels this Post was tagged with.

publishedstring

RFC 3339 date-time when this Post was published.

readerComments'ALLOW' | 'DONT_ALLOW_SHOW_EXISTING' | 'DONT_ALLOW_HIDE_EXISTING'

Comment control and display setting for readers of this post.

selfLinkstring

The API REST URL to fetch this resource from.

status'LIVE' | 'DRAFT' | 'SCHEDULED' | 'SOFT_TRASHED'

Status of the post. Only set for admin-level requests.

titlestring

The title of the Post.

titleLinkstring

The title link URL, similar to atom's related link.

trashedstring

RFC 3339 date-time when this Post was last trashed.

updatedstring

RFC 3339 date-time when this Post was last updated.

urlstring

The URL where this Post is displayed.

Response

Successful response