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

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

Low-level operation to update Pinterest Ads ads with a raw PATCH payload; only the provided fields are changed. Use focused operations first when available, for example pinterest\_ads\_update\_ad\_status or pinterest\_ads\_rename\_ad. Use pinterest\_ads\_list\_ads 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`  |
| **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.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| `ad_id`          | string or SelectItem | Yes      | -       | Pinterest ad ID to update. Markifact sends it as id; do not repeat it inside update\_payload.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `update_payload` | object or string     | Yes      | -       | Ad 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), destination\_url, customizable\_cta\_type, click\_tracking\_url, view\_tracking\_url, android\_deep\_link, ios\_deep\_link, carousel\_destination\_urls / carousel\_android\_deep\_links / carousel\_ios\_deep\_links (arrays, one entry per card), lead\_form\_id, grid\_click\_type, is\_removable. Prefer pinterest\_ads\_update\_ad\_status and pinterest\_ads\_rename\_ad for plain status or name changes. Example: \{"destination\_url": "`https://example.com/sale`", "customizable\_cta\_type": "SHOP\_NOW"} |
| `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\_id, updated\_fields, endpoint, final payload, and dry\_run status.

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