Skip to main content
POST
Create a post

Authorizations

Authorization
string
header
required

A workspace API key: Authorization: Bearer osk_...

Path Parameters

workspace
string<uuid>
required

Your workspace UUID. Must match the API key's workspace.

Body

application/json
versions
object[]
required
Minimum array length: 1
accounts
integer[]

Account ids (from List accounts) to publish to.

Example:
tags
integer[]

Tag ids.

date
string | null

YYYY-MM-DD

Example:

"2026-10-20"

time
string | null

HH:mm

Example:

"09:00"

timezone
string

Timezone for date and time.

Example:

"Europe/London"

schedule
boolean

Schedule for date and time.

schedule_now
boolean

Publish immediately.

queue
boolean

Add to the next free slot in the posting schedule.

Response

201 - application/json

Created

id
integer
uuid
string<uuid>
status
enum<string>
Available options:
draft,
scheduled,
publishing,
published,
failed,
needs_approval,
approval_denied
accounts
object[]
versions
object[]
tags
object[]
user
object
scheduled_at
string | null

YYYY-MM-DD HH:mm:ss, UTC

published_at
string | null
partially_published_at
string | null
failed_at
string | null
created_at
string
trashed
boolean