Ocoya API
Search
K

Schedule a post

Create scheduled post or draft.
post
https://app.ocoya.com/api/_public/v1
/schedules
Create scheduled post or draft

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

Parameters
No parameters
Body
Example
Schema
{
"caption": "Happy new year everyone!",
"mediaUrls": [
"https://yourmediaurl.com"
],
"socialProfileIds": [
"clh49poxf008x8kov4ncbjty9"
],
"scheduledAt": "2024-01-01T00:00:00.000Z",
"isShadow": false
}
Responses
201: Created
Created
500: Internal Server Error
Unknown error

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)
format
string
no
Format value from Formats
isShadow
boolean
no
Shadow posts will not appear in your dashboard. Defaults to false

Sample response

1
{
2
"postGroupId": "clg07n1us0002998kbzmp7zc7",
3
"scheduleGroupId": "clha31piz00383b76wqxprn6p"
4
}

Response parameters

Parameter
Type
Description
postGroupId
string
Id of the created post
scheduleGroupId
string
Id of the created schedule