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

# Create Promotions

> Creates Pinterest Ads promotions (discount offers shown on ads, such as 15% sitewide or in stores)

Creates Pinterest Ads promotions (discount offers shown on ads, such as 15% sitewide or in stores). A promotion only appears on ads once it is attached to an ad group through promotion\_id in pinterest\_ads\_update\_ad\_group.

| | |
| - | - |
| **App** | Pinterest Ads |
| **Operation ID** | `pinterest_ads_create_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 to create the promotions in. |
| `promotions` | array of object or string | Yes | - | Promotions to create as a JSON list of native Pinterest promotion objects, up to 100 per run. Each needs promotion\_title (internal name) and promotion\_type (for example SITEWIDE, SITEWIDE\_IN\_STORES, FREE\_SHIPPING, BUY\_X\_GET\_Y, CUSTOM). template\_values fills the type's template, up to 2 entries of percent, amount with currency\_code, or custom\_text. Optional: start\_time and end\_time (Unix seconds or ISO datetime, independent of the campaign dates), promotion\_code, promotion\_custom\_id. Pinterest validates each field. A promotion does nothing until it is attached to an ad group: set promotion\_id with pinterest\_ads\_update\_ad\_group. Example: \[\{"promotion\_title": "Winter sale 15%", "promotion\_type": "SITEWIDE", "template\_values": \[\{"percent": 15}], "start\_time": "2026-12-01T00:00:00Z", "end\_time": "2026-12-31T23:59:59Z"}] |

## Output

**Type**: `Dict`

Returns the created 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.