Pause or activate Google Ads entities (`adsap_google_set_entity_status`)

Platform: Google Ads · Read or write: Write · Plan: All plans · Consumes a task: Yes · Preview supported: Yes

What it does

Pauses or reactivates Google Ads campaigns, ad groups, ads or keywords, up to 20 per call. A preview shows the current and new status, validated by Google, before anything changes.

When to use it

Use it to pause or reactivate Google Ads campaigns, ad groups, ads or keywords. One call takes up to 20 IDs of a single entity_type.
It supports a preview call. With dry_run set to true, Google validates the change and nothing is applied.
Keyword IDs read <ad_group_id>:<criterion_id>. Get them from adsap_google_get_insights at keyword level. Campaign IDs come from adsap_google_list_campaigns.
IDs are handled one at a time, in order. A rate limit or an expired Google connection stops the rest of the batch.
To rename or change a budget, use adsap_google_update_entity. For Meta, use adsap_set_entity_status.

Worked example

You ask

“Show me what would happen if I paused campaign 21000000001 in Google Ads account 1234567890. Do not change anything yet.”

The assistant calls `adsap_google_set_entity_status`


{
  "ad_account_id": "1234567890",
  "entity_type": "campaign",
  "entity_ids": ["21000000001"],
  "action": "pause",
  "dry_run": true
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


{
  "ok": true,
  "dry_run": true,
  "platform": "google",
  "action": "pause",
  "results": [
    {
      "entity_id": "21000000001",
      "ok": true,
      "dry_run": true,
      "platform": "google",
      "entity_type": "campaign",
      "name": "Spring sale",
      "current_status": "ENABLED",
      "changes": [
        {
          "field": "status",
          "current_value": "ENABLED",
          "new_value": "PAUSED",
          "will_change": true
        }
      ],
      "total_would_change": 1,
      "google_validation": "passed",
      "warnings": []
    }
  ]
}

How to read it

results holds one entry per ID. current_status and the changes row use Google’s wording, so an active campaign reads ENABLED. will_change is false when the entity already has the target status. google_validation reads passed when Google accepts the change. Otherwise it carries Google’s error message. The top-level ok is true only when every entry succeeded.

Nothing was applied here. Each entry and the top level also carry a human_readable_summary sentence, left out of this example. To apply the change, the assistant repeats the call with dry_run set to false.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`entity_type`	one of `campaign`, `ad_group`, `ad`, `keyword`	Yes	Google Ads vocabulary: the middle level is ad_group (not adset). keyword targets one ad-group criterion.
`entity_ids`	array of string	Yes
`action`	one of `pause`, `activate`	Yes
`dry_run`	boolean	No	Preview only: the request is validated and the resolved payload returned, nothing is created or changed.
`ad_account_id`	string	Yes	Bare 10-digit Google Ads customer ID (from adsap_google_list_ad_accounts). No dashes, no act_ prefix.

Example prompts

“Pause my Google Search campaign called Summer Sale.”
“Preview pausing every keyword in the Trail Shoes ad group with zero conversions.”
“Reactivate the Brand campaign in my Google Ads account.”

Notes

The copilot only reactivates something when you ask for it in plain terms.

adsap_google_update_entity: Edit an existing Google Ads campaign, ad group, ad, or keyword: change status (PAUSED/ACTIVE), rename (campaign/ad group), set a campaign’s…

Guide

Read Managing Google Ads in bulk for the workflow around this tool, and the Tool reference for every tool.

The Google Ads MCP server page shows how to connect Google Ads to Claude, ChatGPT or Perplexity.

Pause or activate Google Ads entities (adsap_google_set_entity_status)