Skip to main content
POST
Send a server-side conversion

Authorizations

Authorization
string
header
required

JWT token obtained from /api/auth/token endpoint. Token is verified using JWKS and must include a valid user identifier.

Path Parameters

projectId
string<uuid>
required

The project id.

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json
kind
enum<string>
required

The Meta standard event name.

Available options:
Lead,
Purchase,
CompleteRegistration,
AddToCart,
InitiateCheckout,
PageView,
ViewContent,
Subscribe,
Qualified,
Schedule,
Contact,
Showed,
NoShow,
Disqualified
Example:

"Purchase"

value
number

Monetary value of the conversion.

Required range: x >= 0
Example:

49.99

currency
string

ISO 4217 currency code.

Required string length: 3
Example:

"USD"

email
string

Customer email — hashed before delivery.

phone
string

Customer phone — hashed before delivery.

visitorId
string

Sapt first-party visitor id (_sapt_vid), if you have it.

personId
string

CRM Person id to attribute the conversion to.

sourceUrl
string

The page URL where the conversion occurred.

eventId
string

Send the same id from your browser pixel (fbq) so Meta dedupes the browser and server events. Auto-minted and returned if omitted.

Example:

"your-order-id-123"

Response

Conversion accepted

eventId
string
required

The event_id delivered to Meta — reconcile against your browser pixel.