Parameters

NameTypeRequiredDescription
brandIdstringYesOcoya brand id from ocoya_list_brands.
captionstringNoPost caption text.
mediaUrlsstring[]NoOptional publicly reachable media URLs. Maximum 10.
channelIdsstring[]NoChannel ids from ocoya_list_channels to attach to the post.
scheduledAtstringNoOptional ISO datetime. Omit to save as draft.
publishNowbooleanNoPublish immediately through Ocoya scheduling.
optionsobjectNoPer-network settings, keyed by network. Each applies only when the post has a channel on that network; on update only the fields sent change.

Request example

{
  "name": "ocoya_create_post",
  "arguments": {
    "brandId": "cmayvq3hk00017apshay5qezu",
    "caption": "Launching our summer campaign today.",
    "channelIds": ["clh49poxf008x8kov4ncbjty9"],
    "scheduledAt": "2026-07-01T09:00:00Z"
  }
}

Returns

Returns postGroupId, status and scheduledAt. This tool creates content, which can reach your connected networks once it publishes.