Schedule a post

Create scheduled post or draft.

Create a scheduled post or draft

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

POSThttps://app.ocoya.com/api/_public/v1/schedules

Body

application/json

one of

objectobjectobject

Response

201500

Created

Request

JavaScriptCurlPython

const response = await fetch('https://app.ocoya.com/api/_public/v1/schedules', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "caption": "Happy new year everyone!",
      "mediaUrls": [
        "https://yourmediaurl.com"
      ]
    }),
});
const data = await response.json();

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

{
    "postGroupId": "clg07n1us0002998kbzmp7zc7",
    "scheduleGroupId": "clha31piz00383b76wqxprn6p"
}

Response parameters

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