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

# Create Custom Conversion

> Creates a Meta custom conversion on an ad account, defined by a rule over pixel events or URLs (e.g

Creates a Meta custom conversion on an ad account, defined by a rule over pixel events or URLs (e.g. thank-you page visits), with a standard event category and optional default value. Use meta\_list\_account\_pixels for event\_source\_id and meta\_list\_custom\_conversions to see existing ones.

| | |
| - | - |
| **App** | Meta Ads |
| **Operation ID** | `meta_create_custom_conversion` |
| **Type** | Action |
| **Connection** | `meta_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 Meta Ads account, ask the user for it if not provided |
| `name` | string | Yes | - | Name for the custom conversion |
| `description` | string | No | - | Optional description |
| `event_source_id` | string | No | - | Pixel ID or offline event set ID the conversion listens to, e.g. from meta\_list\_account\_pixels. Required in practice for pixel-based conversions. |
| `rule` | object or string | No | - | Conversion rule sent to Meta as-is: JSON filtering on url or event with operators like i\_contains, contains, eq, gt, lt, regex\_match. Example (purchase page): \{"and": \[\{"event": \{"eq": "PageView"}}, \{"or": \[\{"URL": \{"i\_contains": "thank-you"}}]}]}. Provide rule or advanced\_rule to define when the conversion fires. |
| `advanced_rule` | object or string | No | - | Advanced ruleset supporting multiple event sources, sent to Meta as-is. Use rule for simple cases. |
| `custom_event_type` | string or SelectableOption | No | - | Standard event category the conversion is optimized as, e.g. PURCHASE, LEAD, OTHER |
| `action_source_type` | string or SelectableOption | No | - | Where the conversion happens, e.g. website, physical\_store, phone\_call |
| `default_conversion_value` | number | No | - | Default monetary value assigned to each conversion, in the account currency |

### SelectableOption

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

## Output

**Type**: `Dict`

Returns the created custom conversion id and name.

**Fields**: `custom_conversion_id`, `name`


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