ZuckerBot › Tool reference › Conversion tracking (CAPI)

Send CAPI Event

zuckerbot_send_capi_event

Manually send a Conversions API event for a business contact/lead. Useful for debugging CAPI pipelines, testing stage mappings with real user data, or sending events from custom integrations not covered by the webhook. Authenticates with the business API key OR with an x-zuckerbot-webhook-secret header if using the webhook path.

Parameters

Name	Type		Description
`business_id`	string	optional	Optional business ID override (resolved from API key when omitted)
`source_stage`	string	required	CRM stage key to map to a Meta event (e.g., 'lead', 'salesqualifiedlead', 'customer')
`crm_source`	string	optional	Optional CRM source label override (e.g., 'hubspot', 'salesforce')
`lead_id`	string	optional	Optional ZuckerBot lead ID for attribution matching
`meta_lead_id`	string	optional	Optional Meta Lead Gen Ads lead ID for attribution matching
`email`	string	optional	Optional contact email for identity matching
`phone`	string	optional	Optional contact phone for identity matching
`first_name`	string	optional	Optional first name for identity matching
`last_name`	string	optional	Optional last name for identity matching
`value`	number	optional	Optional event value override in major currency units
`event_time`	string	optional	Optional ISO 8601 event timestamp. Defaults to now.
`fbclid`	string	optional	Optional Facebook click ID; the server builds a well-formed fbc cookie from it
`fbc`	string	optional	Optional pre-formatted Facebook click cookie (fb.1.<ms>.<fbclid>), forwarded raw — never hashed
`fbp`	string	optional	Optional Facebook browser ID cookie (_fbp), forwarded raw — never hashed. Improves match quality for every event

Example call

{
  "tool": "zuckerbot_send_capi_event",
  "arguments": {
    "source_stage": "<source_stage>"
  }
}

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