> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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. Can be a string, number, regex, or a list of strings.                                                                                 |

### 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.