---
title: "POST /v3/blogs/{blogId}/posts"
method: POST
path: "/v3/blogs/{blogId}/posts"
tags: ["posts"]
---

# POST /v3/blogs/{blogId}/posts

`POST /v3/blogs/{blogId}/posts`

Inserts a post.

## Path parameters

- `blogId` string, required

## Query parameters

- `fetchBody` boolean
- `fetchImages` boolean
- `isDraft` boolean

## Request body

- Post
  - `author` object — The author of this Post.
    - `id` string — The identifier of the creator.
    - `displayName` string — The display name.
    - `image` object — The creator's avatar.
      - `url` string — The creator's avatar URL.
    - `url` string — The URL of the creator's Profile page.
  - `selfLink` string — The API REST URL to fetch this resource from.
  - `published` string — RFC 3339 date-time when this Post was published.
  - `labels` string[] — The list of labels this Post was tagged with.
  - `kind` string — The kind of this entity. Always blogger#post.
  - `images` object[] — Display image for the Post.
    - `url` string
  - `customMetaData` string — The JSON meta-data for the Post.
  - `titleLink` string — The title link URL, similar to atom's related link.
  - `blog` object — Data about the blog containing this Post.
    - `id` string — The identifier of the Blog that contains this Post.
  - `trashed` string — RFC 3339 date-time when this Post was last trashed.
  - `id` string — The identifier of this Post.
  - `location` object — The location for geotagged posts.
    - `lat` number, double — Location's latitude.
    - `name` string — Location name.
    - `lng` number, double — Location's longitude.
    - `span` string — Location's viewport span. Can be used when rendering a map preview.
  - `status` 'LIVE' | 'DRAFT' | 'SCHEDULED' | 'SOFT_TRASHED' — Status of the post. Only set for admin-level requests.
  - `replies` object — The container of comments on this Post.
    - `items` Comment[] — The List of Comments for this Post.
      - `updated` string — RFC 3339 date-time when this comment was last updated.
      - `kind` string — The kind of this entry. Always blogger#comment.
      - `content` string — The actual content of the comment. May include HTML markup.
      - `post` object — Data about the post containing this comment.
        - `id` string — The identifier of the post containing this comment.
      - `id` string — The identifier for this resource.
      - `selfLink` string — The API REST URL to fetch this resource from.
      - `published` string — RFC 3339 date-time when this comment was published.
      - `status` 'LIVE' | 'EMPTIED' | 'PENDING' | 'SPAM' — The status of the comment (only populated for admin users).
      - `inReplyTo` object — Data about the comment this is in reply to.
        - `id` string — The identified of the parent of this comment.
      - `author` object — The author of this Comment.
        - `url` string — The URL of the creator's Profile page.
        - `id` string — The identifier of the creator.
        - `displayName` string — The display name.
        - `image` object — The creator's avatar.
          - `url` string — The creator's avatar URL.
      - `blog` object — Data about the blog containing this comment.
        - `id` string — The identifier of the blog containing this comment.
    - `totalItems` string, int64 — The count of comments on this post.
    - `selfLink` string — The URL of the comments on this post.
  - `content` string — The content of the Post. May contain HTML markup.
  - `url` string — The URL where this Post is displayed.
  - `updated` string — RFC 3339 date-time when this Post was last updated.
  - `title` string — The title of the Post.
  - `readerComments` 'ALLOW' | 'DONT_ALLOW_SHOW_EXISTING' | 'DONT_ALLOW_HIDE_EXISTING' — Comment control and display setting for readers of this post.
  - `etag` string — Etag of the resource.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/blogger.md) · [All operations](https://skmtc.net/google/apis/blogger/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/blogger/revisions/65cc82d5d69f/schema)