Quickstart: your first conversion in 5 minutes

Five minutes, one event, one dashboard update. This is the shortest possible path to a working integration — the full integration guide fills in the detail later.

1. Create a space and a link

In the dashboard, create a space (your project) and a link (your funnel entry point). The link gives you a slug and a landing that mints uids.

2. Grab a key

Open API keys → Rotate bearer. Copy the secret (shown once). That's your write credential.

3. Fire one event

curl -X POST https://xtracker.cc/events \
  -H "Authorization: Bearer <BEARER>" \
  -H "Content-Type: application/json" \
  -d '{"event":"deposit","value":"25.00","currency":"USD","eid":"test-1"}'

You'll get back:

{"ok": true, "status": "queued"}

4. Watch it land

Open your space dashboard. Within a second or two the deposit shows up in the live event feed, the revenue widget ticks up by $25, and the funnel records a deposit.

Fire the same command again — note the response is now "status": "duplicate". That's the eid doing its job: the same external id is never counted twice.

What just happened

You sent a canonical event (deposit) to your space. XTRACKER wrote it to a durable inbox, deduped it, and (if you've configured a destination) is already forwarding it to Facebook CAPI / your webhook / a postback.

Next steps

• Integrate your app properly — bind uids, fire the whole funnel, use the Python client.
• Understand canonical events — when to fire each of the four.
• Connect a destination — send conversions to Meta, a webhook, or an affiliate network.