Send Conversion Event (CAPI)
meta_send_conversion_eventSend server-side conversion events to Meta using the Conversions API. Supports standard and custom events with deduplication for accurate attribution.
Instructions
Sends a server-side conversion event to Meta via the Conversions API.
Args:
pixel_id: Meta Pixel ID
event_name: Standard events: Purchase, Lead, AddToCart, CompleteRegistration, ViewContent, Search, InitiateCheckout, AddPaymentInfo, AddToWishlist, Subscribe, StartTrial, Contact, CustomizeProduct, Donate, FindLocation, Schedule, SubmitApplication, PageView. Custom event names also accepted.
event_time: Unix timestamp
event_source_url (optional): URL where conversion happened
user_data: At minimum one of: em (hashed email), ph (hashed phone), fbc, fbp, client_ip_address, client_user_agent, external_id
custom_data (optional): { currency, value, content_name, content_ids, content_type, order_id, num_items }
event_id (optional): For deduplication with browser pixel
action_source: "website", "app", "email", "phone_call", "chat", "physical_store", "system_generated", "business_messaging", "other"
test_event_code (optional): For testing without affecting production data
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pixel_id | Yes | Meta Pixel ID | |
| event_name | Yes | Conversion event name. Standard events: Purchase, Lead, AddToCart, CompleteRegistration, ViewContent, Search, InitiateCheckout, AddPaymentInfo, AddToWishlist, Subscribe, StartTrial, Contact, CustomizeProduct, Donate, FindLocation, Schedule, SubmitApplication, PageView. Custom event names are also accepted. | |
| event_time | Yes | Unix timestamp of the event | |
| event_source_url | No | URL where conversion happened | |
| user_data | Yes | User data for matching (at least one identifier required — more fields = better match rate) | |
| custom_data | No | Custom event data | |
| event_id | No | Deduplication ID (matches browser pixel) | |
| action_source | Yes | Where the conversion originated | |
| test_event_code | No | Test event code (won't affect production data) | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |