Google Ads Write
🚨 **IF THIS TOOL RETURNS A QUOTA ERROR:** - The error message will include a clickable upgrade link - Show the FULL error message to the user (it contains the upgrade link) - DO NOT attempt to work ar
POST https://api.adspirer.ai/api/v1/tools/create_shopping_campaign/execute
Authorization: Bearer sk_live_... — your Adspirer API key (required)Content-Type: application/json (required)Idempotency-Key: <uuid> — recommended for write operations to make retries safeAll tool arguments are wrapped in an arguments object.
| Field | Type | Description |
|---|---|---|
campaign_name | string required | Campaign name (e.g. 'Summer Catalog Shopping'). |
budget_daily | number required | Daily budget in the account's native currency. Do NOT convert currencies — pass the user's amount as-is. |
merchant_id | string required | The linked Merchant Center account ID whose product feed this campaign advertises. Get it from get_merchant_center_links (link one first with link_merchant_center if none). |
feed_label | string optional | Merchant Center feed label for the products to advertise. MUST match a feed label that exists in the linked Merchant Center account, or the campaign will serve ZERO products. Leave unset (omit) to target products that have no feed label — the common single-feed case. Do NOT guess a country code; confirm the account's actual feed label first. |
bidding_strategy | string optional | MANUAL_CPC (default, classic Shopping) | TARGET_SPEND (Maximize Clicks) | TARGET_ROAS | MAXIMIZE_CONVERSION_VALUE | MAXIMIZE_CONVERSIONS | TARGET_CPA. default: "MANUAL_CPC" |
target_roas | number optional | Target ROAS (e.g. 4.0 = 400%). REQUIRED if bidding_strategy=TARGET_ROAS; optional booster for MAXIMIZE_CONVERSION_VALUE. |
target_cpa_micros | integer optional | Target CPA in micros. REQUIRED if bidding_strategy=TARGET_CPA; optional for MAXIMIZE_CONVERSIONS. |
cpc_bid_ceiling_micros | integer optional | Max CPC bid limit (micros) for automated strategies (Target ROAS/CPA/Max Clicks). |
cpc_bid_floor_micros | integer optional | Min CPC bid limit (micros) for Target ROAS/CPA/Max-Conv-Value. |
enhanced_cpc | boolean optional | Enable Enhanced CPC for MANUAL_CPC bidding. default: false |
campaign_priority | integer optional | Standard Shopping priority 0 (low, default) / 1 / 2 (high) — which campaign wins for a product when several overlap. Leave 0 unless you run multiple Shopping campaigns. default: 0 |
enable_local | boolean optional | Include local-inventory (in-store) products from the Merchant Center feed. Default false. default: false |
disable_product_feed | boolean optional | Disable the product feed (feedless Shopping). Advanced; leave unset normally. |
network_settings | any optional | Which networks to serve on. Omit for Google's Shopping defaults. |
ad_groups | array optional | Multiple ad groups to create, each with its own name/cpc_bid/num_product_ads. Omit to create a single default ad group (use ad_group_name/cpc_bid_micros below). |
ad_group_name | string optional | Name for the single initial ad group (when ad_groups is not used). |
cpc_bid_micros | integer optional | Default max CPC (micros) for the single initial ad group (when ad_groups is not used). |
num_product_ads | integer optional | Number of product ads in the single initial ad group (when ad_groups is not used). default: 1 |
start_date | string optional | Start date YYYYMMDD (optional). |
end_date | string optional | End date YYYYMMDD (optional). |
customer_id | string optional | Google Ads customer ID (10 digits, no dashes). REQUIRED whenever the user has more than one Google Ads account connected — this creates a REAL campaign that spends REAL money, so it must land in the account the user actually meant. Do NOT omit it and do NOT guess: carry over the customer_id already in use in this conversation, or call list_connected_accounts / get_connections_status and ask the user which account. If a call fails asking you to disambiguate, RETRY with this parameter — that error does NOT mean the account is disconnected. |
{
"arguments": {
"campaign_name": "string",
"budget_daily": 1.0,
"merchant_id": "string",
"feed_label": "string",
"bidding_strategy": "MANUAL_CPC",
"target_roas": 1.0,
"target_cpa_micros": 1,
"cpc_bid_ceiling_micros": 1,
"cpc_bid_floor_micros": 1
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for create_shopping_campaign)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "create_shopping_campaign"
}
{
"success": false,
"error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n - Acme Holdings (ad_account_id=\"act_123456789\")\n - Acme EU (ad_account_id=\"act_987654321\")",
"is_error": true,
"tool": "create_shopping_campaign"
}
{
"success": false,
"error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
"is_error": true,
"tool": "create_shopping_campaign",
"quota": {
"used": 150,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01",
"upgrade_url": "https://adspirer.ai"
}
}
Interactive: Swagger UI
Machine-readable: OpenAPI 3.1 spec · llms-full.txt
More tools: Google Ads · All tools
Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai