Send server-side event
curl --request POST \
--url https://track.scanova.io/server-events \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"site_id": "site_abc123",
"event_name": "purchase",
"scan_session_id": "550e8400-e29b-41d4-a716-446655440000",
"conversion_value": {
"amount": 99.99,
"currency": "USD"
},
"user_identifiers": {
"email_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"external_id": "user_12345"
},
"properties": {
"order_id": "order_789",
"product_ids": [
"prod_1",
"prod_2"
]
}
}
'{
"success": true,
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"message": "Event received"
}API Reference
Server Events API — POST /server-events
Send a single authenticated server-side conversion event — purchase, signup, lead, or any backend action — attributed to a QR Code scan.
POST
/
server-events
Send server-side event
curl --request POST \
--url https://track.scanova.io/server-events \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"site_id": "site_abc123",
"event_name": "purchase",
"scan_session_id": "550e8400-e29b-41d4-a716-446655440000",
"conversion_value": {
"amount": 99.99,
"currency": "USD"
},
"user_identifiers": {
"email_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"external_id": "user_12345"
},
"properties": {
"order_id": "order_789",
"product_ids": [
"prod_1",
"prod_2"
]
}
}
'{
"success": true,
"event_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"message": "Event received"
}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
Site-scoped server API key generated from Dashboard > Integrations > Conversion Tracking > Script/API > API tab
Body
application/json
Tracking site ID
Required string length:
1 - 64Event name (normalized to lowercase/underscore by API)
Required string length:
1 - 64QR scan session id from scnv redirect
Unique event ID for deduplication
Event occurrence time
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Custom properties. Max serialized size 10KB. Do not include raw email addresses.
Consent signal propagated from browser-side tracking
Available options:
granted, denied, pending Was this page helpful?
⌘I