---
title: "Create a scheduled or a draft post"
method: POST
path: "/post"
---

# Create a scheduled or a draft post

`POST /post`

Returns an id of the post

## Query parameters

- `workspaceId` string, required

## Request body

- union
  - object
    - `caption` string, required — Text caption for the post.
    - `mediaUrls` unknown[], required — Publicly accessible media URLs to attach to the post.
      - unknown
    - `socialProfileIds` unknown[] — Connected social profile IDs that should receive the post. Get IDs from `GET /social-profiles`.
      - unknown
    - `scheduledAt` string — ISO 8601 datetime when the post should be scheduled. Omit to save as draft.
  - object
    - `caption` string, required — Text caption for the post.
    - `socialProfileIds` unknown[] — Connected social profile IDs that should receive the post. Get IDs from `GET /social-profiles`.
      - unknown
    - `scheduledAt` string — ISO 8601 datetime when the post should be scheduled. Omit to save as draft.
  - object
    - `mediaUrls` unknown[], required — Publicly accessible media URLs to attach to the post.
      - unknown
    - `socialProfileIds` unknown[] — Connected social profile IDs that should receive the post. Get IDs from `GET /social-profiles`.
      - unknown
    - `scheduledAt` string — ISO 8601 datetime when the post should be scheduled. Omit to save as draft.

## Response `201`

Created

## Other responses

- `500` — Unknown error

---

[API](https://skmtc.dev/ocoya/apis/ocoya-api.md) · [All operations](https://skmtc.dev/ocoya/apis/ocoya-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ocoya/ocoya-api/revisions/80ba891a0523/schema)