API Reference

Google Ads / API Reference

google_ads_add_audience_to_campaign

Google Ads tool. Prefer the actions marked RECOMMENDED for everyday Google Ads workflows. Add a remarketing audience (user list) to a campaign. By default adds as OBSERVATION (bid-only, doesn't restrict reach). Set observation_only=False for TARGETING mode (only shows ads to audience members). Args: campaign_id: Campaign ID to add the audience to. user_list_id: ID of the user list/audience (from google_ads_audience_performance or the Google Ads UI). bid_modifier: Bid adjustment for this audience (e.g. 1.3 = +30% for audience members). observation_only: True = add as observation (bid adjustment only). False = targeting (restrict to audience). customer_id: Google Ads customer ID. Leave blank to use default.

This is a write tool: it adds audience to campaign in your Google Ads account. Claude asks you to confirm before it runs.

Ask Claude

You do not call this tool yourself. Ask for the outcome and the client picks the tool:

Add audience to campaign in my Google Ads account for [campaign id], [user list id].

It takes 2 required and 3 optional parameters.

Parameters

ParameterTypeRequiredDescription
campaign_idstringYesCampaign Id
user_list_idstringYesUser List Id
bid_modifiernumberNoBid Modifier
observation_onlybooleanNoObservation Only
customer_idstringNoCustomer Id

Related Google Ads tools

Before you can call it

This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.

Workflows that use this

Rather than calling tools one at a time, these skills run a whole procedure against the same account:

Start using MCP Ads