Skip to main content
POST
/
api
/
conversions
/
track
curl -X POST https://api.linquid.io/api/conversions/track \
  -H "X-API-Key: lw_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "clickId": "abc123xyz789",
    "event": "purchase",
    "value": 99.99,
    "currency": "USD",
    "orderId": "ORD-12345"
  }'

{
  "success": true,
  "data": {
    "conversionId": "conv_def456",
    "clickId": "abc123xyz789",
    "event": "purchase",
    "value": 99.99,
    "currency": "USD",
    "orderId": "ORD-12345",
    "tracked": true,
    "timestamp": "2024-01-15T14:30:00.000Z"
  }
}

​
Request Body

​
pixelId
string
Pixel ID (if using managed pixels)
​
clickId
string
required
The click ID (lw_cid) from the URL
​
event
string
default:"conversion"
Conversion event type (e.g., purchase, lead, signup)
​
value
number
Conversion value/amount
​
currency
string
default:"USD"
ISO currency code
​
orderId
string
Your unique order/transaction ID
​
metadata
object
Additional custom data
curl -X POST https://api.linquid.io/api/conversions/track \
  -H "X-API-Key: lw_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "clickId": "abc123xyz789",
    "event": "purchase",
    "value": 99.99,
    "currency": "USD",
    "orderId": "ORD-12345"
  }'

{
  "success": true,
  "data": {
    "conversionId": "conv_def456",
    "clickId": "abc123xyz789",
    "event": "purchase",
    "value": 99.99,
    "currency": "USD",
    "orderId": "ORD-12345",
    "tracked": true,
    "timestamp": "2024-01-15T14:30:00.000Z"
  }
}

​
Notes

  • The clickId must be valid and within the attribution window (default: 30 days)
  • Duplicate conversions with the same orderId are rejected
  • Values are automatically converted to USD for reporting