ZuckerBot › Tool reference › Conversion tracking (CAPI)

Get Custom Conversion

zuckerbot_get_custom_conversion

Read one custom conversion in full: rule, source event (event_source_id/event_source_type), category (custom_event_type), default conversion value, availability (is_unavailable) and creation time, plus mutable_fields — the only fields Meta permits updating (name, description, default_conversion_value; rule/category/source are immutable). Optionally include stats via include_stats with an explicit bounded window (default: last 30 days, capped at 90). A pure read of the already-bound ad account — it never binds or consumes an ad-account slot.

Parameters

Name	Type		Description
`conversion_id`	string	required	Numeric Meta custom conversion id — list them with zuckerbot_list_custom_conversions
`business_id`	string	optional	Optional business ID override for the authenticated API key
`include_stats`	boolean	optional	Set true to include conversion stats for a bounded window (default: last 30 days)
`stats_since`	string	optional	Stats window start, YYYY-MM-DD (UTC, inclusive). Defaults to 30 days before stats_until.
`stats_until`	string	optional	Stats window end, YYYY-MM-DD (UTC, inclusive). Defaults to today.
`stats_aggregation`	string	optional	Stats aggregation: count (default), device_type, host, pixel_fire, unmatched_count, unmatched_usd_amount, url or usd_amount

Example call

{
  "tool": "zuckerbot_get_custom_conversion",
  "arguments": {
    "conversion_id": "<conversion_id>"
  }
}

You never invoke this directly — describe what you want in plain English inside Claude, Cursor, ChatGPT or any MCP client with ZuckerBot connected, and the agent selects zuckerbot_get_custom_conversion and fills the arguments for you.

Related tools — Conversion tracking (CAPI)

Connect ZuckerBot to your AI agent in about two minutes: get started free, browse the full tool reference, or grab the lifetime deal.