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

# Manage Conversion Events

> Creates, updates, or deletes an account's advertiser-defined (custom) conversion events

Creates, updates, or deletes an account's advertiser-defined (custom) conversion events. Each event maps a raw event name you send Pinterest to a Pinterest standard event, so Pinterest optimizes and reports on it as that standard event. Event names must match what you pass Pinterest exactly. Use pinterest\_ads\_list\_conversion\_events to see what already exists before changing anything.

| | |
| - | - |
| **App** | Pinterest Ads |
| **Operation ID** | `pinterest_ads_manage_conversion_events` |
| **Type** | Action |
| **Connection** | `pinterest_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |
| **Requires approval** | Yes (write operation) |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `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"] |

### SelectableOption

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

## Output

**Type**: `Dict`

Returns the number of events changed and their names. The count key is created\_count, updated\_count, or deleted\_count depending on update\_type.

**Fields**: `created_count`, `updated_count`, `deleted_count`, `event_names`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.