Create a scheduled post or draft

Returns the id of created schedule (draft), and id of the post group.

post

/post

Authorizations

Query parameters

workspaceIdstring

Body

one of

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app.ocoya.com/api/_public/v1/post' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "caption": "Happy new year everyone!",
    "mediaUrls": [
      "https://yourmediaurl.com"
    ],
    "socialProfileIds": [
      "clh49poxf008x8kov4ncbjty9"
    ],
    "scheduledAt": "2024-01-01T00:00:00Z"
  }'

201

500

201

No body

Created

Request parameters

Parameter	Type	Required	Information
caption	string	yes (if mediaUrls not provided)	Up to 10,000 characters
mediaUrls	array of strings	yes (if caption not provided)	URL list of the media (must follow URL file limitations)
socialProfileIds	array of strings	no	If no ids provided, creates post as a draft
scheduledAt	string	no	Date of the schedule (must follow Date limitations)

Sample response

{
    "postGroupId": "clg07n1us0002998kbzmp7zc7",
}

Response parameters

Parameter	Type	Description
postGroupId	string	Id of the created post