> ## 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. optimization\_goal\_metadata is only writable for conversion objectives (SALES, LEADS, legacy WEB\_CONVERSION), using conversion\_tag\_v3\_goal\_metadata with conversion\_event, reporting\_event, conversion\_tag\_id, cpa\_goal\_value\_in\_micro\_currency, or attribution\_windows. The CONSIDERATION 'Optimization' selector in Ads Manager (Pin clicks vs outbound clicks / landing page) CANNOT be changed through the Pinterest API. It is a campaign-wide setting that Ads Manager applies to every ad group in the campaign; the API only reads it back on the ad group as outbound\_click\_goal\_metadata.is\_outbound\_click\_optimized, rejects every attempt to write it there with 'Invalid parameters' (create and update), and exposes nothing for it on the campaign, where the same keys are silently dropped with a 200 and nothing changes. Tell the user to change it in Ads Manager; do not retry via pinterest\_ads\_update\_campaign, a success there proves nothing. Writing conversion\_tag\_v3\_goal\_metadata into a CONSIDERATION ad group is accepted and echoed back by pinterest\_ads\_list\_ad\_groups but does not change that selector, so reading the value back is not proof the setting took effect. Once set, optimization\_goal\_metadata cannot be cleared: \{} is a no-op and null fails with a server error. There is no optimization\_type field on an ad group; it exists only on Pinterest's delivery-estimates endpoint, and Pinterest silently drops it (and any other unknown key) from an update instead of returning an error. 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`