Skip to main content

​
Parameters

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.

​
Request 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.