account | DynamicAccount | Yes | - | Select the Pinterest Ads account that owns the conversion events. |
update_type | string or SelectableOption | Yes | - | What to do: create new advertiser-defined events, update the mapping of existing ones, or delete (untrack) them. Create and update take the same events list; delete takes event_names. |
events | array of object or string | No | - | Events to create or update, as a JSON list of objects. Each object needs ‘name’ (your raw event name, matched exactly against what you send Pinterest; letters, digits, underscores, hyphens, and spaces only, up to 50 characters) and ‘mapped_conversion_type’ (the Pinterest standard event it optimizes as). Up to 100 events per run. Required when update_type is create or update. Example: [{“name”: “add_shipping_info”, “mapped_conversion_type”: “CHECKOUT”}, {“name”: “newsletter_signup”, “mapped_conversion_type”: “SIGNUP”}] |
event_names | string or array of string | No | - | Names of the events to stop tracking, as a JSON list of strings or a comma-separated string. Required when update_type is delete. Example: [“add_shipping_info”, “newsletter_signup”] |
