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

> Updates Pinterest Ads promotions by ID: title, type, discount values, dates or code, or archives them (status ARCHIVED removes a promotion permanently)

Updates Pinterest Ads promotions by ID: title, type, discount values, dates or code, or archives them (status ARCHIVED removes a promotion permanently). An edit applies to every ad group using that promotion.

| | |
| - | - |
| **App** | Pinterest Ads |
| **Operation ID** | `pinterest_ads_update_promotions` |
| **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 the Pinterest Ads account that owns the promotions. |
| `promotions` | array of object or string | Yes | - | Promotion updates as a JSON list of native Pinterest objects, up to 100 per run. Each needs id (from pinterest\_ads\_list\_promotions) plus only the fields to change: promotion\_title, promotion\_type, template\_values, start\_time, end\_time (Unix seconds or ISO datetime), promotion\_code. An edit applies to every ad group using that promotion. discount\_status cannot be set: Pinterest computes it from the start and end times, so end a promotion by moving end\_time. status ARCHIVED removes a promotion permanently: it disappears from the list and can no longer be changed. Example: \[\{"id": "7834020830107", "template\_values": \[\{"percent": 10}]}] |

## Output

**Type**: `Dict`

Returns the updated promotion IDs and the promotions as Pinterest returned them.

**Fields**: `promotion_ids`, `promotions`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.