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/add_demandgen_ad/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 |
|---|---|---|
ad_group_id | string required | The EXISTING Demand Gen ad group ID to add the ad to. Get from get_campaign_structure (must be a DEMAND_GEN ad group). |
ad_format | string optional | Ad format: 'multi_asset' (image ads, default) or 'video_responsive' (video ads). default: "multi_asset" |
final_url | string required | Landing page URL where users go after clicking the ad. **REQUIRED — ask the user for their website URL before calling this tool. Do NOT guess.** Must be HTTPS and reachable. Example: 'https://example.com/product'. |
business_name | string required | Business name, max 25 characters. |
headlines | array required | MUST BE JSON ARRAY: 1-5 headlines, each max 40 characters. |
descriptions | array required | MUST BE JSON ARRAY: 1-5 descriptions, each max 90 characters. |
long_headlines | array optional | Optional 1-5 long headlines, max 90 chars each. Used by video_responsive format. |
call_to_action | string optional | CTA label: LEARN_MORE, SHOP_NOW, SIGN_UP, SUBSCRIBE, DOWNLOAD, BOOK_NOW, etc. |
marketing_images | array optional | Landscape images (1.91:1) as [{"url": "...", "name": "img1"}]. |
square_marketing_images | array optional | Square images (1:1) as [{"url": "...", "name": "img1"}]. |
portrait_marketing_images | array optional | Portrait images (4:5) as [{"url": "...", "name": "img1"}]. |
existing_images | object optional | Existing image asset resource names to reuse. Keys: marketing_images_landscape, marketing_images_square, marketing_images_portrait, logos_square. |
youtube_video_ids | array optional | YouTube video IDs for video_responsive format. 1-5 videos. |
logo_asset_id | string optional | Logo image asset ID from discover_existing_assets. |
logo_images | array optional | New logo images as [{"url": "...", "name": "logo1"}]. |
customer_id | string optional | Google Ads customer ID. Required for multi-account users. Get from get_connections_status. |
{
"arguments": {
"ad_group_id": "string",
"final_url": "https://example.com",
"business_name": "string",
"headlines": [
"string"
],
"descriptions": [
"string"
],
"ad_format": "multi_asset",
"long_headlines": [
"string"
],
"call_to_action": "string",
"marketing_images": [
{}
],
"square_marketing_images": [
{}
],
"portrait_marketing_images": [
{}
]
}
}
{
"success": true,
"data": {
"text": "(tool-specific textual output for add_demandgen_ad)",
"quota": {
"used": 42,
"limit": 150,
"tier": "plus",
"period_end": "2026-05-01"
}
},
"tool": "add_demandgen_ad"
}
{
"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": "add_demandgen_ad"
}
{
"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": "add_demandgen_ad",
"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