`meta_ads_list_custom_conversions`

List Meta Custom Conversions

Description

List custom conversion definitions for a Meta ad account, including ID, name, custom_event_type, event_source_id, rule JSON, retention_days, default_conversion_value, and description. Use this to inspect tracking setup and understand URL/event matching rules behind conversions such as offsite_conversion.fb_pixel_custom.*.

Read-onlyIdempotentOpen-world

Usage

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "meta_ads_list_custom_conversions",
    "arguments": {
      "account_id": "act_123456789",
      "reason": "Inspect custom conversion URL and event matching rules"
    }
  }
}

hopkin meta custom-conversions list

Flag	Type	Required	Description
`--account`	`string`	Required	The ad account ID (with or without act_ prefix)
`--limit`	`integer`	Optional	Custom conversions per page (default: 100, max: 100)
`--cursor`	`string`	Optional	Pagination cursor from previous response

{
  "mcpServers": {
    "meta-ads": {
      "url": "https://meta.mcp.hopkin.ai",
      "transport": "sse"
    }
  }
}

Parameters

Name	Type	Required	Description
`account_id`	`string`	Required	The ad account ID (with or without act_ prefix)minLength: 1
`reason`	`string`	Required	Why this tool call is neededminLength: 1, maxLength: 500

Optional parameters (2)

Name	Type	Required	Description
`limit`	`integer`	Optional	Custom conversions per page (default: 100, max: 100)min: 1, max: 100
`cursor`	`string`	Optional	Pagination cursor from previous responseminLength: 1

Examples

Audit tracking rules

{
  "account_id": "act_123456789",
  "reason": "Inspect custom conversion URL and event matching rules"
}

hopkin meta custom-conversions list --account act_123456789

Find SurveyClick rule

{
  "account_id": "123456789",
  "reason": "Brief PM on how SurveyClick custom conversion is triggered"
}

hopkin meta custom-conversions list --account 123456789