API Reference › Google Ads › add_search_campaign_image

add_search_campaign_image

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

Endpoint

POST https://api.adspirer.ai/api/v1/tools/add_search_campaign_image/execute

Headers

Description

🚨 **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 around the error or use alternative data - DO NOT create campaigns or perform actions without valid tool data - STOP and direct the user to upgrade via the provided link Upload + link an image asset at the SEARCH campaign level. For PMax campaigns use `add_pmax_asset_group_image` instead (PMax links at asset-group level). This tool is for Search campaigns where image assets attach at campaign level via CampaignAssetService. Valid `field_type` values (Search campaigns only): - AD_IMAGE — promotional image extension (used by default; always works) - BUSINESS_LOGO — brand logo (requires an identity-verified advertiser) The MARKETING_IMAGE family and LOGO/LANDSCAPE_LOGO are Performance Max / asset-group image types — Google REJECTS them on a Search campaign. For those, use `add_pmax_asset_group_image` on a PMax campaign instead. **Parameters:** - campaign_id: The Search campaign ID - image_url: http(s) URL OR `data:image/...;base64,...` URI - field_type: AD_IMAGE (default) or BUSINESS_LOGO — omit to use AD_IMAGE - asset_name: optional display name in the Asset Library - customer_id: Optional (uses connected account if omitted) **Execution time:** 3-8 seconds (image fetch + Google Ads mutate) **Example:** User: "Upload this image (https://...) to campaign 23847465076" Agent: add_search_campaign_image(campaign_id="23847465076", image_url="https://...") # defaults to AD_IMAGE

Request body

All tool arguments are wrapped in an arguments object.

FieldTypeDescription
campaign_idstring requiredThe Search campaign ID (numeric). Get from list_campaigns.
image_urlstring requiredImage to upload. Either a public http(s) URL OR a base64 data URI (`data:image/png;base64,...`). Plain base64 without the data-URI prefix is NOT accepted.
field_typestring optionalAsset slot — one of: AD_IMAGE, BUSINESS_LOGO. Omit to use AD_IMAGE (a promotional image extension; always works). BUSINESS_LOGO = a brand logo (needs an identity-verified advertiser). For PMax MARKETING_IMAGE/LOGO assets use add_pmax_asset_group_image.
asset_namestring optionalOptional display name for the asset in the Google Ads Asset Library (visible in the UI; doesn't affect rendering).
customer_idstring optionalGoogle Ads customer ID. Required for multi-account users. Get from get_connections_status.

Example request

{
  "arguments": {
    "campaign_id": "<campaign_id>",
    "image_url": "https://example.com",
    "field_type": "string",
    "asset_name": "string",
    "customer_id": "string"
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for add_search_campaign_image)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "add_search_campaign_image"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "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_search_campaign_image"
}

402 — Quota exhausted

{
  "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_search_campaign_image",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

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