Skip to main content
POST
Send server-side event
Use this endpoint to report a single backend conversion event. For sending multiple events in one request, use POST /server-events/batch. Generate the required X-API-Key from your tracking site: Integrations → Conversion Tracking → (select site) → API Keys. See Send Server Events for code examples in Node.js, Python, PHP, and cURL.

Authorizations

X-API-Key
string
header
required

Site-scoped server API key generated from Dashboard > Integrations > Conversion Tracking > Script/API > API tab

Body

application/json
site_id
string
required

Tracking site ID

Required string length: 1 - 64
event_name
string
required

Event name (normalized to lowercase/underscore by API)

Required string length: 1 - 64
scan_session_id
string<uuid>

QR scan session id from scnv redirect

event_id
string<uuid>

Unique event ID for deduplication

event_time
string<date-time>

Event occurrence time

user_identifiers
object
conversion_value
object
properties
object

Custom properties. Max serialized size 10KB. Do not include raw email addresses.

Consent signal propagated from browser-side tracking

Available options:
granted,
denied,
pending

Response

Event accepted

success
boolean
required
Example:

true

event_id
string<uuid>
required
message
string
required
Example:

"Event received"