AdCopilot docsby Atromx
Tool reference

Campaign tools

Create Search and Performance Max campaigns, change budgets, networks, bidding and languages, and pause or re-enable them. Every write is proposed first.

View as Markdown
Open inClaudePerplexity

These tools create and steer campaigns; Campaign and keyword changes shows them in use. All are writes, each proposed first. For a hard stop, set your AI client to ask before AdCopilot's write tools: Needs approval in Claude; in Cursor, set the run mode to Allowlist and keep them off the allowlist (Cursor's cloud agents never ask). All four are checked against your saved budget on AdCopilot's server; see The budget checks.

create_campaign

Write. Creates a campaign with a budget. A Search campaign is created with Google search on, Search partners off, the Display Network off, and location targeting set to people in the places you target. Ask for other settings if you want them.

negative_geo_target_type chooses who the locations you exclude apply to: PRESENCE (people in an excluded location) or PRESENCE_OR_INTEREST (people in an excluded location or interested in it). It is set only when you ask for it. You exclude locations with set_geo_targets.

A Search campaign has no language setting: Google removed it in late September 2026 and shows Search ads by the language they are written in. Write the ads in the language your customers search in. A search in another language that costs money is stopped with a negative keyword; analyze_search_terms names those searches.

Create a Search campaign "Invoicing — Search" with a $30/day budget.

A campaign AdCopilot builds with you is created paused, and it will not switch it on for you. A call that asks for status ENABLED is refused, and nothing in it runs; you switch the campaign on in Google Ads.

create_performance_max_campaign

Write. Creates a Performance Max campaign with a budget, a business name and a logo. languages (Google Ads language codes such as en, hi or es) sets who it shows to on YouTube, Display, Discover and Gmail; on Google Search, Google matches a Performance Max campaign by the language of its ads. Without languages it can show to people who use any language. See Performance Max.

Like create_campaign, it builds the campaign paused: status ENABLED is refused, and nothing in that call runs.

update_campaign

Write. Changes an existing campaign: name, daily budget, start and end dates, Search partners, the Display Network, location targeting type, who excluded locations apply to (negative_geo_target_type, as on create_campaign), bidding strategy (with its target CPA, target ROAS or maximum cost per click), and the languages of a Performance Max, Display or Video campaign.

It does not change a campaign's status: set_campaign_status does that. A call to update_campaign that carries a status is refused, and nothing in it runs; the other changes in it go through when sent again without the status. A new start or end date on a campaign that is switched on but has ended starts it spending again; see The budget checks.

languages sets exactly the languages you give and removes the rest; ["all"] removes every language setting. It works on any Performance Max, Display or Video campaign, including one created in the Google Ads interface; one with no language setting can show to people who use any language. A Search campaign has no language setting, so languages is refused there.

Raise the daily budget on "Invoicing — Search" to $45.

A budget above your comfortable daily budget goes through with a warning. A raise past your monthly cap, and Maximize Clicks with no per-click cap, are refused.

set_campaign_status

Write. Enables or pauses a campaign. It is the only tool that changes the status of a campaign that already exists. REMOVED is refused: pausing is the reversible stand-in for deleting.

Claude Code (version 2.1.214 or later) always asks before this tool runs. It shows its permission prompt before every pause or switch-on, even if you set write tools to run without asking, and it offers no "don't ask again". When nobody is there to answer, as in claude -p or a scheduled run nobody is watching, the campaign is not paused or switched on. The Claude desktop app may also ask every time for this tool. Elsewhere it is your AI client's setting: for a hard stop, set it to ask before AdCopilot's write tools (Needs approval in Claude; in Cursor, the Allowlist run mode with them off the allowlist, and Cursor's cloud agents never ask).

Pause "Holiday — Search"; we are done for the season.

On this page