account | DynamicAccount | Yes | - | Select Pinterest Ads account to create keywords in. |
parent_type | string or SelectableOption | Yes | - | What the keywords target. ADVERTISER applies them account-wide. CAMPAIGN, AD_GROUP, or AD scope them to that entity. Advertisers and campaigns can only take excluding match types (EXACT_NEGATIVE or PHRASE_NEGATIVE); ad groups and ads accept any match type. |
campaign_id | string or SelectItem | No | - | Pinterest campaign ID. Required when parent_type is CAMPAIGN. |
ad_group_id | string or SelectItem | No | - | Pinterest ad group ID. Required when parent_type is AD_GROUP. |
ad_id | string | No | - | Pinterest ad ID. Required when parent_type is AD. |
keywords | array of object or string | Yes | - | Keywords to create as a JSON list of objects. Each object requires ‘value’ (keyword text, up to 120 characters) and ‘match_type’ (BROAD, PHRASE, EXACT, EXACT_NEGATIVE, or PHRASE_NEGATIVE). Advertiser- and campaign-level keywords only accept EXACT_NEGATIVE or PHRASE_NEGATIVE. Up to 100 keywords per run. Pinterest’s ‘bid’ field on keywords is deprecated and always ignored, so do not include it. Example: [{“value”: “running shoes”, “match_type”: “BROAD”}, {“value”: “-competitor brand”, “match_type”: “EXACT_NEGATIVE”}] |
