List Conversion Events

Lists the advertiser-defined (custom) conversion events tracked for a Pinterest Ads account and the standard conversion type each maps to

Lists the advertiser-defined (custom) conversion events tracked for a Pinterest Ads account and the standard conversion type each maps to.

App	Pinterest Ads
Operation ID	pinterest_ads_list_conversion_events
Type	Action
Connection	pinterest_ads (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
account	DynamicAccount	Yes	-	Select the Pinterest Ads account whose advertiser-defined conversion events should be listed.
filters	array of FilterItem	No	-	Additional filters to apply when retrieving conversion events. The available fields to filter by are: - name: Filter by the raw event name - mapped_conversion_type: Filter by the standard conversion type the event maps to (for example SIGNUP or CHECKOUT) Filters are combined using AND logic. If you want to use OR logic, use relevant operators like REGEXP_MATCH or IN_LIST.
limit	integer	No	100	Maximum number of conversion events to return. Default: 100.

FilterItem

Field	Type	Required	Default	Description
field	string or SelectableOption	Yes	-	The field to filter on, must be one of the current selected metrics or dimensions.
operator	string	Yes	-	The operator to use for filtering. Must be one of the supported values. Use REGEXP_MATCH to search/filter by multiple OR values like ’.(summer|holiday).’
value	string	Yes	-	The value to filter by, always as a string: text, a number, or a regex. For IN_LIST and NOT_IN_LIST, pass the values as one comma-separated string such as ‘a,b,c’, not as an array. For regex values, escape backslashes once in the JSON string: write \b for a word boundary, not \b.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: List[Dict]

Returns custom conversion events with name and mapped_conversion_type.