ocoya_create_ai_campaign - Ocoya API Docs

Parameters

Name	Type	Required	Description
`brandId`	string	Yes	Brand ID from `ocoya_list_brands`.
`prompt`	string	Yes	Campaign prompt or brief.
`goal`	string	No	One of `awareness`, `leads`, `launch`, `offer`, `education`, `event`. Defaults to `awareness`.
`audience`	string	No	One of `business_owners`, `founders_executives`, `marketing_teams`, `buyers_customers`, `local_community`, `investors`, `first_time_buyers`, `existing_customers`. Defaults to `business_owners`.
`duration`	number	No	Campaign duration in days, from 1 to 30. Defaults to 7.
`count`	number	No	Number of posts to generate, from 3 to 30. Defaults to 5.
`postLength`	string	No	One of `short`, `medium`, `long`, `extra_long`. Defaults to `medium`.
`tone`	string	No	One of `professional`, `friendly`, `educational`, `bold`, `founder_led`. Defaults to `professional`.
`hashtagLibraryId`	string	No	Hashtag library ID from `ocoya_list_hashtag_libraries`.
`socialProfileIds`	string[]	No	Connected social profile IDs to attach when generated campaign posts are saved.
`generateMedia`	boolean	No	Whether to generate images for campaign posts.
`imageCount`	number	No	Number of images to generate for each campaign post, from 1 to 10. Values above 1 create carousel-style post creatives. Defaults to 1.
`referenceUrls`	string[]	No	Image URLs to use as visual references when `generateMedia` is `true`. Maximum 3.
`referenceDesignIds`	string[]	No	Studio design IDs from `ocoya_list_studio_templates` to use as visual references when `generateMedia` is `true`. Maximum 3.

Request example

{
  "name": "ocoya_create_ai_campaign",
  "arguments": {
    "brandId": "cmayvq3hk00017apshay5qezu",
    "prompt": "Summer launch campaign for our ecommerce analytics dashboard",
    "goal": "launch",
    "audience": "marketing_teams",
    "duration": 10,
    "count": 6,
    "postLength": "medium",
    "tone": "professional",
    "hashtagLibraryId": "cmayw7l5200067apsmz2tv7e8",
    "socialProfileIds": ["clh49poxf008x8kov4ncbjty9"],
    "generateMedia": true,
    "imageCount": 3
  }
}

Returns

Returns the queued campaign ID, GENERATING status, and generation progress metadata. This tool does not wait for generated posts. Campaign generation runs in the background, so clients should treat the immediate response as a queued job and check the campaign later in Ocoya.