Add ads
Create one or many ads under ad sets.
Tool name: add-ads.
Create one or many ads under ad sets. Pass an ads: [...] array, each entry targets its own adsetNodeId and may attach creativeId and/or copyGenerationId in the same call, avoiding follow-up updateNode. Unknown adsetIds return in notFound, per-ad create errors in failed; the rest are created (partial success is fine). When the user provided explicit per-ad names in their message, pass each literal name verbatim per ads[].name, naming convention applies only when the user did not specify names.
When to use
Create 1-N ads in one call (heterogeneous per-ad creative/copy assignments allowed). The unified ad-creation tool, handles single and bulk. Unknown adsetIds return in notFound; per-ad create errors in failed.
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | No |
| Idempotent | No |
| Open world | No |
Input
| Field | Type | Required | Description |
|---|---|---|---|
campaignLaunchId | string | Yes | Campaign launch ID (a.k.a. batch ID). Read it from the Current Context block when one is in scope, or resolve it from a mention via listAccountCampaigns / the campaign tree when the user @-mentioned a different launch. |
ads | object[] | Yes | Ads to create (1-100). Each entry targets a specific adsetNodeId with optional creativeId and copyGenerationId. At least 1 item, at most 100 items. |
ads[].adsetNodeId | string | Yes | Target ad set ID for this ad |
ads[].name | string | No | Name for the new ad |
ads[].creativeId | number | No | Numeric creative ID to attach on create |
ads[].copyGenerationId | number | No | Numeric copy generation ID (from generateCopy) to attach on create |
Output
The tool catalog does not declare an output schema for this tool.
REST equivalent
POST /v1/brands/{brandId}/launches/{launchId}/ads, Add ads. CLI: koast add-ads.
Upload creative
Store an image in the active brand's creative library and return its creativeId, ready to put in an ad with addAds, distributeCreative or swapCreatives.
Add ad set
Add a new ad set to a campaign, and optionally apply targeting/budget/schedule/goal settings AT CREATE time via the settings map (dot-notation paths, same shape as updateSettings).