MCP tools
Distribute creative
Distribute a single creative across multiple ad sets or campaigns.
Tool name: distribute-creative.
Distribute a single creative across multiple ad sets or campaigns. Either creates a new ad per target (newAdPerTarget) or replaces the first existing ad (replaceFirstAd).
When to use
Push one creative across many ad sets/campaigns, either creating a new ad per target or replacing the first existing ad. NOT for attaching a creative to a single ad (use updateNode with creativeId).
Access
| Property | Value |
|---|---|
| Required scope | write |
| Publishes | No |
| Read-only | No |
| Destructive | Yes |
| 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. |
creativeId | integer | Yes | |
targets | object | Yes | |
targets.adsetIds | string[] | No | |
targets.campaignIds | string[] | No | |
strategy | string | Yes | One of newAdPerTarget, replaceFirstAd. |
Output
The tool catalog does not declare an output schema for this tool.
REST equivalent
POST /v1/brands/{brandId}/launches/{launchId}/creatives/distribute, Distribute creative. CLI: koast distribute-creative.