Facebook Conversions API (CAPI) - Server-Side Events avatar

Facebook Conversions API (CAPI) - Server-Side Events

Under maintenance

Pricing

from $0.01 / 1,000 results

Go to Apify Store
Facebook Conversions API (CAPI) - Server-Side Events

Facebook Conversions API (CAPI) - Server-Side Events

Under maintenance

Send offline conversions & server-side events to Meta Conversions API. Track purchases, leads & custom events for Facebook and Instagram ads attribution. Send a single conversion event Send multiple events List all pixels in ad account Get pixel details and stats Validate before sending

Pricing

from $0.01 / 1,000 results

Rating

0.0

(0)

Developer

The Howlers

The Howlers

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

7 days ago

Last modified

Share

Send offline conversions and server-side events to Meta Conversions API. Track purchases, leads, and custom events with automatic PII hashing for Facebook and Instagram ads.

BYOK (Bring Your Own Key) -- you provide your own API credentials.


Before You Start

This actor requires your own API credentials to fetch real data.

Where to get your key: Facebook Marketing API access token


Quick Start

Run with real data

{
"task": "send_event",
"accessToken": "YOUR_API_KEY_HERE",
"eventName": "Purchase",
"country": "US",
"eventSourceUrl": "https://example.com",
"currency": "USD",
"contentType": "product",
"actionSource": "website",
"isAlreadyHashed": false
}

Input Parameters

ParameterTypeDefaultRequiredDescription
taskstring"send_event"Yes*The operation to perform
accessTokenstring-Yes*Facebook Marketing API access token
pixelIdstring-NoFacebook Pixel ID to send events to
testEventCodestring-NoTest event code from Events Manager (for testing only)
eventNamestring"Purchase"NoStandard or custom event name
customEventNamestring-NoName for custom event (if eventName is CustomEvent)
eventsstring-NoJSON array of event objects for batch sending
emailstring-NoCustomer email (will be hashed)
phonestring-NoCustomer phone (will be hashed)
firstNamestring-NoCustomer first name (will be hashed)
lastNamestring-NoCustomer last name (will be hashed)
citystring-NoCustomer city (will be hashed)
statestring-NoCustomer state (will be hashed)
countrystring"US"NoCustomer country code
zipCodestring-NoCustomer zip/postal code (will be hashed)
externalIdstring-NoYour unique customer identifier
fbclidstring-NoFacebook click ID from URL parameter
fbpstring-NoFacebook browser ID cookie value
fbcstring-NoFacebook click ID cookie value
eventTimestring-NoEvent timestamp (ISO 8601 or Unix timestamp)
eventSourceUrlstring-NoURL where the conversion occurred
valuenumber-NoMonetary value of the conversion
currencystring"USD"NoISO 4217 currency code
orderIdstring-NoUnique order/transaction identifier
contentIdsstring-NoComma-separated product/content IDs
contentTypestring"product"NoType of content
actionSourcestring"website"NoWhere the conversion originated
isAlreadyHashedbooleanfalseNoSet to true if PII data is already SHA256 hashed
webhookUrlstring-NoURL to receive results via webhook

Pricing

This actor uses pay-per-event billing:

EventDescriptionPrice
Conversion SentEach conversion event sent to Meta CAPI$0.01

Troubleshooting

"API key is required"

  • Add your API key in the input

"API error 403" or "Unauthorized"

Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

  • Invalid input format (check the examples above)
  • API key without proper permissions
  • The target data doesn't exist or is too small to track

How do I test without an API key?


Built by John Rippy | Actor Arsenal