add_keywords
Batch-add search keywords to a Google Ads ad group with preview-before-confirm and CPC bid limit checks.
Instructions
Add keywords to an ad group (batch operation).
Safety: new keywords are live immediately in an enabled ad group, so this
returns a preview first; call again with confirm=True. Refused if any
cpc_bid is above GOOGLE_ADS_MAX_CPC_BID.
Args:
customer_id: Google Ads customer ID.
ad_group_id: Ad group ID to add keywords to.
keywords: List of keyword dicts, each with:
- text (str): The keyword text.
- match_type (str): 'EXACT', 'PHRASE', or 'BROAD'.
- cpc_bid (float, optional): Max CPC bid in currency.
Example:
keywords=[
{"text": "buy shoes online", "match_type": "PHRASE", "cpc_bid": 1.50},
{"text": "running shoes", "match_type": "BROAD"},
{"text": "[red running shoes]", "match_type": "EXACT", "cpc_bid": 2.00},
]
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"customer_id": "<customer_id>",
"ad_group_id": "<ad_group_id>",
"keywords": "<keywords>"
},
"name": "add_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| confirm | No | ||
| keywords | Yes | ||
| ad_group_id | Yes | ||
| customer_id | Yes |