Skip to main content

​
ocoya_create_ai_post

Generates a ready-to-edit Ocoya draft post from a prompt using AI. It can optionally apply a brand kit, attach connected social profiles, connect a reusable hashtag library, and generate one square image. This tool uses the same generation flow as the New AI post composer in Ocoya.

​
Arguments

NameTypeRequiredDescription
workspaceIdstringYesWorkspace ID from ocoya_list_workspaces.
promptstringYesWhat the post should be about. Minimum 10 characters.
brandIdstringNoBrand kit ID from ocoya_list_brand_kits.
tonestringNoCaption tone. One of professional, friendly, educational, bold, founder_led. Defaults to professional.
lengthstringNoCaption length. One of short, medium, long, extra_long. Defaults to medium.
socialProfileIdsstring[]NoConnected social profile IDs to attach to the draft.
hashtagLibraryIdstringNoHashtag library ID from ocoya_list_hashtag_libraries.
generateImagebooleanNoWhether to generate one square image for the draft.
referenceUrlsstring[]NoImage URLs to use as visual references when generateImage is true.
referenceDesignIdsstring[]NoStudio design IDs from ocoya_list_studio_templates to use as visual references when generateImage is true.

​
Example

{
  "name": "ocoya_create_ai_post",
  "arguments": {
    "workspaceId": "cmayvq3hk00017apshay5qezu",
    "prompt": "Create a LinkedIn post announcing our new analytics dashboard for ecommerce brands.",
    "tone": "professional",
    "length": "medium",
    "socialProfileIds": ["clh49poxf008x8kov4ncbjty9"],
    "hashtagLibraryId": "cmayw7l5200067apsmz2tv7e8",
    "generateImage": true,
    "referenceDesignIds": ["design_123"]
  }
}

​
Returns

Returns post action details such as post group ID, status, and schedule. The generated post is saved as an editable Ocoya draft unless the normal post review flow later schedules or publishes it.