> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Keyword Bid

> Updates the max CPC bid of Google Ads keywords, one keyword or in bulk

Updates the max CPC bid of Google Ads keywords, one keyword or in bulk. Keyword bids override the ad group bid.

|                       |                           |
| --------------------- | ------------------------- |
| **App**               | Google Ads                |
| **Operation ID**      | `gads_update_keyword_bid` |
| **Type**              | Action                    |
| **Connection**        | `gads` (required)         |
| **Credits per run**   | 1                         |
| **Agent / MCP tool**  | Yes                       |
| **Requires approval** | Yes (write operation)     |

## Inputs

| Field             | Type                                                              | Required | Default | Description                                                                                                                                                                                                                                                                                |
| ----------------- | ----------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `account`         | GadsAccountItem or object or array of object or string or integer | Yes      | -       | Select the Google Ads account, ask user for it if not provided                                                                                                                                                                                                                             |
| `update_type`     | string or SelectableOption                                        | Yes      | -       | Choose whether to update a single keyword or multiple keywords at once. Available options: 'single' (Single Update), 'bulk' (Bulk Updates)                                                                                                                                                 |
| `keyword_id`      | string or SelectableOption                                        | No       | -       | Required for 'single' update mode. Accepts a bare numeric criterion ID (combine with ad\_group\_id, since the same criterion ID can exist in several ad groups), '\<adGroupId>~~\<criterionId>', or a full resource path 'customers/\<cust>/adGroupCriteria/\<adGroupId>~~\<criterionId>'. |
| `ad_group_id`     | string or SelectableOption                                        | No       | -       | Ad group ID for 'single' update mode. Recommended when keyword\_id is a bare criterion ID; ignored if keyword\_id already encodes the ad group.                                                                                                                                            |
| `cpc_bid`         | number                                                            | No       | -       | Required for 'single' update mode. The keyword's new max CPC bid in the account currency, e.g. 1.25 for \$1.25. It overrides the ad group bid.                                                                                                                                             |
| `structured_data` | array (also accepts a comma-separated string)                     | No       | -       | Required when update type is 'bulk'. Each row must contain 'keyword\_id' and 'cpc\_bid' (max CPC in account currency), and should contain 'ad\_group\_id' when keyword\_id is a bare criterion ID. keyword\_id accepts the same formats as in single mode.                                 |

### GadsAccountItem

| Field       | Type   | Required | Default | Description                                                                                                                                                    |
| ----------- | ------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `value`     | string | Yes      | -       |                                                                                                                                                                |
| `label`     | string | Yes      | -       |                                                                                                                                                                |
| `managerId` | string | Yes      | -       | The manager ID for the Google Ads account. Ask  user to use the dropdown to select accounts, this manager id is selected background and not shown to the user. |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `str`

Returns success message confirming keyword bid update.