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