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