Trackli Docs

Get up and running with Trackli in three simple steps. Create your account, generate an API key, and start tracking referrals.

# Store your API key
export TRACKLI_API_KEY="tk_live_your_key_here"

# Record your first conversion
curl -X POST https://trytrackli.com/api/conversion \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $TRACKLI_API_KEY" \
  -d '{
    "customerEmail": "buyer@example.com",
    "affiliateRefCode": "partner123",
    "orderAmount": 4900,
    "currency": "usd"
  }'

Referral links are the foundation of affiliate tracking. When a visitor clicks a referral link, Trackli records the click server-side and redirects to your destination URL with the ref code appended. Attribution is handled via server-side matching — no cookies required.

How it works

1. Affiliate shares their unique referral link
2. Visitor clicks the link — Trackli records the click (timestamp, IP, user agent)
3. Visitor is redirected to your destination URL with the ref code passed as a URL parameter
4. When the visitor purchases, pass the ref code to POST /api/conversion or include it in your payment platform metadata

Example URLs

# Redirect-based tracking link
GET https://trytrackli.com/yourbrand/partner123

# The system will:
# 1. Record the click (affiliate, timestamp, IP, user agent)
# 2. Redirect the visitor to your destination URL
#    e.g. https://yoursite.com?ref=partner123

# Your app should persist the ref parameter and
# include it when calling the conversion API or
# pass it in your payment platform metadata (e.g. Stripe checkout metadata)

All endpoints accept and return JSON. Authenticate with an X-API-Key header. Base URL: https://trytrackli.com/api

curl -X POST https://trytrackli.com/api/conversion \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tk_live_your_key_here" \
  -d '{
    "customerEmail": "buyer@example.com",
    "affiliateRefCode": "partner123",
    "orderAmount": 4900,
    "currency": "usd"
  }'

const res = await fetch("https://trytrackli.com/api/conversion", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.TRACKLI_API_KEY,
  },
  body: JSON.stringify({
    customerEmail: "buyer@example.com",
    affiliateRefCode: "partner123",
    orderAmount: 4900,
    currency: "usd",
  }),
});

const data = await res.json();
console.log(data);
// { id: "conv_abc123", status: "recorded" }

curl -X POST https://trytrackli.com/api/track/order \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tk_live_your_key_here" \
  -d '{
    "stripeEventId": "evt_1abc",
    "amountTotal": 4900,
    "currency": "usd",
    "customerEmail": "buyer@example.com",
    "affiliateRefCode": "partner123"
  }'

const res = await fetch("https://trytrackli.com/api/track/order", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.TRACKLI_API_KEY,
  },
  body: JSON.stringify({
    stripeEventId: "evt_1abc",
    amountTotal: 4900,
    currency: "usd",
    customerEmail: "buyer@example.com",
    affiliateRefCode: "partner123",
  }),
});

const data = await res.json();
console.log(data);
// { order: { id: "ord_xyz" }, commission: { id: "com_456", amount: 490, status: "pending" } }

Trackli uses API keys to authenticate requests to the public ingestion API. Generate a key from your dashboard under Settings. Include it in every request as an X-API-Key header.

Generating an API key

1. Log in to your Trackli dashboard
2. Navigate to Settings
3. Click Generate API Key
4. Copy and store the key securely — it is shown only once

Using your API key

Pass your key in the X-API-Key request header. The key is validated on every call to the public API endpoints (POST /api/conversion and POST /api/track/order).

# Include the key in the X-API-Key header on every request
curl -X POST https://trytrackli.com/api/conversion \
  -H "Content-Type: application/json" \
  -H "X-API-Key: tk_live_your_key_here" \
  -d '{
    "customerEmail": "buyer@example.com",
    "affiliateRefCode": "partner123",
    "orderAmount": 4900,
    "currency": "usd"
  }'

# 401 is returned if the key is missing or invalid
# { "message": "Invalid or missing API key" }

const res = await fetch("https://trytrackli.com/api/conversion", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.TRACKLI_API_KEY,
  },
  body: JSON.stringify({
    customerEmail: "buyer@example.com",
    affiliateRefCode: "partner123",
    orderAmount: 4900,
    currency: "usd",
  }),
});

if (res.status === 401) {
  throw new Error("Invalid or missing API key");
}
const data = await res.json();