ZuckerBot › Tool reference › Conversion tracking (CAPI)

Sync Conversion

zuckerbot_sync_conversion

Send downstream conversion quality feedback to Meta via CAPI. When a ZuckerBot-sourced lead converts (sale, appointment, qualified call) or bounces (uncontactable, bad fit), reporting it here teaches Meta's algorithm to find more (or fewer) people like them — improving lead quality over time. Call this from your CRM when a lead status changes.

Parameters

Name	Type		Description
`campaign_id`	string	required	ZuckerBot campaign ID
`lead_id`	string	required	Lead ID to report conversion for
`quality`	"good" \| "bad"	required	Lead quality: 'good' = converted/contacted, 'bad' = lost/unresponsive
`meta_access_token`	string	required	User's Meta access token for CAPI
`user_data`	object	optional	Optional user data to improve match rate
`fbclid`	string	optional	Optional Facebook click ID; the server builds a well-formed fbc cookie from it
`fbc`	string	optional	Optional pre-formatted fbc cookie, forwarded raw — never hashed
`fbp`	string	optional	Optional _fbp browser cookie, forwarded raw — never hashed. Improves match quality

Example call

{
  "tool": "zuckerbot_sync_conversion",
  "arguments": {
    "campaign_id": "<campaign_id>",
    "lead_id": "<lead_id>",
    "quality": "good",
    "meta_access_token": "<meta_access_token>"
  }
}

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