Create image ad (pipeline)
x_ads_create_image_adCreate an image ad for an active ad group: upload a creative, set the website card, and promote it. Requires media, text, and destination URL; halts if the creative fails to process.
Instructions
Composite: upload creative → website card → nullcast post → promote onto an EXISTING ad group. Provide media_url or inline image. Requires text + destination_url. Serves only when campaign and ad group are ACTIVE. If the intended creative failed to upload or process, STOP. Do not promote a still, a source image, or a pre-existing library asset.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"account_id": "<account_id>",
"line_item_id": "<line_item_id>",
"text": "<text>",
"destination_url": "<destination_url>"
},
"name": "x_ads_create_image_ad"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| text | Yes | ||
| image | No | ||
| media_url | No | ||
| account_id | Yes | Ads API account id from x_ads_list_accounts, e.g. 18ce55v2od2 | |
| line_item_id | Yes | ||
| destination_url | Yes |