---
search:
  tags:
    - Posts
    - POST
seo:
  description: >-
    If action is omitted, the post is scheduled when scheduled_at is present and
    published… Reference for the POST /api/cli/posts endpoint in the
    BrainyShorts API.
sidebar:
  label: Create a post
  badge: POST
title: Create a post
type: openapi-operation
---
**If `action` is omitted, the post is scheduled when `scheduled_at` is present and published immediately otherwise.** Send `action: "draft"` to create a draft. Publishing or scheduling to YouTube is not available through this endpoint; use an agent automation instead.

`POST /api/cli/posts`