Skip to main content
POST
/
v1
/
track
/
lead
Track a lead
curl --request POST \
  --url https://go.affixo.dev/v1/track/lead \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "visitor_id": "<string>",
  "fingerprint": "<string>",
  "ref": "<string>",
  "manual_code": "<string>",
  "external_id": "<string>",
  "currency": "usd",
  "is_test": false,
  "url": "<string>",
  "referrer": "<string>"
}
'
{
  "ok": true,
  "attributed": true,
  "conversion_id": "<string>",
  "visitor_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Workspace API key, e.g. sa_live_…. Scopes: read / write / track / *.

Body

application/json

Visitor identity plus optional attribution hints. Provide at least one of visitor_id, fingerprint, ref, or manual_code so the event can be attributed.

​
visitor_id
string | null
​
fingerprint
string | null
​
ref
string | null

Referral code, used to pin the campaign/window.

​
manual_code
string | null

Self-attribution code, if enabled.

​
external_id
string | null

Idempotency key (order id).

​
currency
string
default:usd
Example:

"usd"

​
is_test
boolean
default:false
​
url
string<uri> | null
​
referrer
string | null

Response

Lead processed (attributed or not)

​
ok
boolean
Example:

true

​
attributed
boolean
Example:

true

​
conversion_id
string

Present when attributed.

​
visitor_id
string

Present when not attributed.