Skip to main content

​
ocoya_create_post

Creates a draft or scheduled social post in Ocoya. It can also publish immediately when publishNow is true.

​
Arguments

NameTypeRequiredDescription
workspaceIdstringYesWorkspace ID from ocoya_list_workspaces.
captionstringNoPost caption text.
mediaUrlsstring[]NoOptional publicly reachable media URLs. Maximum 5.
socialProfileIdsstring[]NoConnected social profile IDs to attach to the post.
scheduledAtstringNoOptional ISO datetime. Omit to save as draft.
publishNowbooleanNoPublish immediately through Ocoya scheduling.
At least one of caption or mediaUrls should be provided.

​
Example

{
  "name": "ocoya_create_post",
  "arguments": {
    "workspaceId": "cmayvq3hk00017apshay5qezu",
    "caption": "Launching our summer campaign today.",
    "mediaUrls": ["https://example.com/image.jpg"],
    "socialProfileIds": ["clh49poxf008x8kov4ncbjty9"],
    "scheduledAt": "2026-07-01T09:00:00Z"
  }
}

​
Returns

Returns post action details such as post group ID, status, and schedule.