> ## 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 Ad Group

> Low-level operation to update Pinterest Ads ad groups with a raw PATCH payload; only the provided fields are changed

Low-level operation to update Pinterest Ads ad groups with a raw PATCH payload; only the provided fields are changed. Use focused operations first when available, for example pinterest\_ads\_update\_ad\_group\_status or pinterest\_ads\_rename\_ad\_group. Use pinterest\_ads\_list\_ad\_groups first to inspect the current payload. Supports dry\_run to preview the final payload without calling Pinterest.

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

## Inputs

| Field            | Type                 | Required | Default | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ---------------- | -------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`        | DynamicAccount       | Yes      | -       | Select Pinterest Ads account that owns the ad group.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `ad_group_id`    | string or SelectItem | Yes      | -       | Pinterest ad group ID to update. Markifact sends it as id; do not repeat it inside update\_payload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `update_payload` | object or string     | Yes      | -       | Ad group fields to update as a JSON object, sent to Pinterest as-is in a PATCH request; only the fields you include are changed. Common fields: name, status (ACTIVE/PAUSED/ARCHIVED), start\_time and end\_time (Unix seconds), targeting\_spec (uppercase keys; use pinterest\_ads\_search\_targeting for IDs), bid\_strategy\_type, placement\_group, pacing\_delivery\_type, auto\_targeting\_enabled, optimization\_goal\_metadata, lifetime\_frequency\_cap, tracking\_urls. Money fields are raw Pinterest microcurrency integers: budget\_in\_micro\_currency and bid\_in\_micro\_currency (multiply the currency amount by 1,000,000, so \$20 is 20000000). Draft ad groups only: billable\_event, budget\_type. Prefer pinterest\_ads\_update\_ad\_group\_status and pinterest\_ads\_rename\_ad\_group for plain status or name changes. Example: \{"budget\_in\_micro\_currency": 20000000, "targeting\_spec": \{"LOCATION": \["US", "CA"]}} |
| `dry_run`        | boolean              | No       | `False` | When true, do not call Pinterest. Return the resolved endpoint and final payload for review.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |

### SelectItem

| Field   | Type   | Required | Default | Description                                                                                          |
| ------- | ------ | -------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `value` | string | Yes      | -       | The value of the selectable item.                                                                    |
| `label` | string | Yes      | -       | The label of the selectable item, used for display purposes. If not provided, defaults to the value. |

## Output

**Type**: `Dict`

Returns ad\_group\_id, updated\_fields, endpoint, final payload, and dry\_run status.

**Fields**: `ad_group_id`, `updated_fields`, `endpoint`, `payload`, `dry_run`