Meta Ads / API Reference
meta_ads_create_custom_conversion
Meta Ads tool. Create a custom conversion from a pixel event with URL conditions. Args: name: Custom conversion name (required). pixel_id: Meta Pixel ID (required). rule: JSON rule for the conversion condition. Example: '{"and":[{"url":{"i_contains":"thank-you"}}]}' (required). custom_event_type: PURCHASE, LEAD, COMPLETE_REGISTRATION, ADD_TO_CART, VIEW_CONTENT, SEARCH, ADD_TO_WISHLIST, ADD_PAYMENT_INFO, INITIATED_CHECKOUT, CONTACT, FIND_LOCATION, SCHEDULE, START_TRIAL, SUBMIT_APPLICATION, SUBSCRIBE, OTHER (required). account_id: Ad account ID. Leave blank to use META_AD_ACCOUNT_ID from .env. description: Optional description.
This is a write tool: it creates custom conversion in your Meta Ads account. Claude asks you to confirm before it runs.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
Create custom conversion in my Meta Ads account for [name], [pixel id], [rule].
It takes 4 required and 2 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name |
pixel_id | string | Yes | Pixel Id |
rule | string | Yes | Rule |
custom_event_type | string | Yes | Custom Event Type |
account_id | string | No | Account Id |
description | string | No | Description |
Related Meta Ads tools
meta_ads_create_ab_testmeta_ads_create_admeta_ads_create_ad_creativemeta_ads_create_adsetmeta_ads_create_adset_with_daypartingmeta_ads_create_advantage_plus_campaign
Before you can call it
This tool needs a connected Meta Ads account. The Meta Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: