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/post

Authorization

ApiKeyAuth

Query parameters

Body

application/json

one of

objectobjectobject

Response

201500

Created

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://app.ocoya.com/api/_public/v1/post', {
    method: 'POST',
    headers: {
      "X-API-Key": "ApiKeyAuth <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "caption": "Happy new year everyone!",
      "mediaUrls": [
        "https://yourmediaurl.com"
      ],
      "socialProfileIds": [
        "clh49poxf008x8kov4ncbjty9"
      ],
      "scheduledAt": "2024-01-01T00:00:00Z"
    }),
});
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)

Sample response

{
    "postGroupId": "clg07n1us0002998kbzmp7zc7",
}

Response parameters

Parameter	Type	Description
postGroupId	string	Id of the created post