Update Keyword
POST
/v1/google-ads/update-keywordUpdate Keyword on Google Ads. Returns a draft with a before→after diff; a human approves it in the SpendSignoff dashboard before anything goes live.
Write tools return drafts
This endpoint stages a change as a draft with a before→after diff. A human approves it with the two-step control in the SpendSignoff dashboard before any spend moves — the model can never push it live.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| account_id | string | yes | The connected ad account ID. |
| keywords | string[] | yes | Keyword texts to add or remove. |
| fields | object | no | Fields to set on the entity. |
Example request
POST /v1/google-ads/update-keyword
{
"account_id": "account_a91f",
"keywords": [
"ai ad management",
"mcp ad server"
],
"fields": {
"example": "value"
}
}Example response
201 — draft created
{
"draft_id": "draft_7c2e",
"status": "pending_approval",
"diff": {
"field": "daily_budget",
"before": 100,
"after": 120
},
"requires": "human_two_step_approve"
}More Google Ads endpoints