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”}] |