Ads Conversions icon

Ads Conversions

Send conversion events to Facebook (Meta) Conversions API and Google Ads. Auto-hashes PII fields.

Actions5

Facebook Conversions → Send Custom Event

AI-generated

Summary

Send a custom-named conversion event to the specified Facebook Pixel using the Facebook Conversions API, including detailed event metadata, user data (auto-normalized and hashed), and optional custom data.

Inputs

  • Pixel ID (required) — The Facebook Pixel ID to send events to.
  • Action Source (required) — Where the conversion took place (e.g., website, email, app).
  • Event Time (required) — Date and time when the event occurred; automatically converted to Unix timestamp.
  • Event Name (required) — The custom event name to send to Facebook.
  • Event ID — Unique event ID for deduplication between Pixel and server events.
  • Event Source URL — The browser URL where the event happened; required if action source is website.
  • Test Event Code — Facebook test event code; when set, events are only used for testing, not for ads.
  • Opt-Out of Ads Delivery Optimization — Flag to use event for attribution only, not ads delivery optimization.
  • Data Processing Options Country — Country code for Facebook data processing options (1=US, 0=geolocate).
  • Data Processing Options State — State code for Facebook data processing options (1000=California, 0=geolocate).
  • User Data — Collection of customer identifiers and PII (e.g., email, phone, name, location). PII fields are normalized and SHA256 hashed before sending.
  • Custom Data — Additional numeric or descriptive data associated with the event (e.g., value, currency, content name).

Output shape

a JSON object reflecting Facebook's API response augmented with sent event payload details and optional warnings

The response includes the Facebook API response along with a _sentPayload summary and a _warnings array if potential issues exist (e.g., missing event_source_url for website action source, empty user_data). Events are sent to the Facebook Pixel specified by Pixel ID using Facebook's v21.0 Graph API.

Examples

Example 1: Send a custom conversion event named 'MyCustomEvent' to Facebook Pixel '1234567890', indicating the event occurred on a website at a specific time, including user data like email and phone (hashed automatically), with custom numeric value and currency.

Specify Pixel ID, action source as 'website', event time, custom event name as 'MyCustomEvent', supply user data fields (email, phone), and optional custom data value and currency.

Links

Discussion