Send server-side conversion events to Meta Conversions API (CAPI)

domain: developers.facebook.com/docs/marketing-api · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Generate a System User access token in Meta Business Manager with the ads_management and business_management permissions and store it server-side
  2. Collect event parameters server-side at conversion time: event_name, event_time (Unix timestamp), event_source_url, and user_data fields (em, ph, client_ip_address, client_user_agent) hashed with SHA-256 where required
  3. POST to the Graph API events endpoint at /{pixel_id}/events using the current Graph API version (v22.0 or later) with the event payload and your access token
  4. Include an event_id field that matches the event_id set in the browser Pixel to enable deduplication across client-side and server-side hits
  5. Use the test_event_code parameter (available in Events Manager) during development to validate that events appear in the Test Events tool before going to production
  6. Monitor the Diagnostics panel in Events Manager for data quality scores and resolve any missing required parameters reported there

Known gotchas

Related routes

Send server-side events via Meta Conversions API
developers.facebook.com/docs/marketing-api/conversions-api · 6 steps · unrated
Send server-side conversion events to Snapchat via the Conversions API (CAPI)
advertising · 6 steps · unrated
Submit Reddit Conversions API (CAPI) server-side events with pixel deduplication
business.reddithelp.com · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans