Parameters
| Name | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | Brand ID from ocoya_list_brands. |
caption | string | No | Post caption text. |
mediaUrls | string[] | No | Optional publicly reachable media URLs. Maximum 10. |
socialProfileIds | string[] | No | Connected social profile IDs to attach to the post. |
scheduledAt | string | No | Optional ISO datetime. Omit to save as draft. |
publishNow | boolean | No | Publish immediately through Ocoya scheduling. |
At least one of caption or mediaUrls should be provided.
Request example
{
"name": "ocoya_create_post",
"arguments": {
"brandId": "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.