---
title: "Create Scheduled Post"
method: POST
path: "/api/v1/scheduled-posts"
tags: ["Social"]
---

# Create Scheduled Post

`POST /api/v1/scheduled-posts`

## Request

- Base URL: `https://api.clipmaster.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.clipmaster.app/api/v1/scheduled-posts`
- Auth: HTTP bearer

Schedule a clip or compilation export for publishing.

The FE triggers the export first (existing export endpoints) and passes
its id. A completed export is copied to durable storage NOW (exports/
expires after 1 day); an in-flight export parks the post in waiting_export
and the publish sweep advances it on completion.

## Request body

- ScheduledPostCreate: A post targets exactly ONE media source: a clip export pair OR a compilation export pair. The FE triggers the export first (existing endpoints) and passes its id alongside its parent's.
  - `social_account_id` integer, required
  - `clip_id` integer, nullable
  - `export_id` integer, nullable
  - `compilation_id` integer, nullable
  - `compilation_export_id` integer, nullable
  - `scheduled_at` string, date-time, required
  - `title` string, nullable
  - `description` string, nullable
  - `hashtags` string[]
  - `privacy` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent.md) · [All operations](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/llms.txt) · [OpenAPI document](https://skmtc.dev/clipmaster/apis/semantic-video-clip-ai-agent/revisions/c9b8333cd22b?raw)