Skip to main content
POST
Create a scheduled or a draft post

Authorizations

X-API-Key
string
header
required

Query Parameters

workspaceId
string
required

Ocoya workspace ID. Get one from GET /workspaces.

Example:

"cmayvq3hk00017apshay5qezu"

Body

application/json
caption
string
required

Text caption for the post.

Example:

"Happy new year everyone!"

mediaUrls
array
required

Publicly accessible media URLs to attach to the post.

Example:
socialProfileIds
array

Connected social profile IDs that should receive the post. Get IDs from GET /social-profiles.

Example:
scheduledAt
string

ISO 8601 datetime when the post should be scheduled. Omit to save as draft.

Example:

"2024-01-01T00:00:00Z"

Response

Created