CAPITIS
Sign inCreate sandbox key

Getting started / Quickstart

Quickstart

Go from an empty account to a tracked link that attributes conversions. Everything below works against a sandbox key.

1. Create an end-user

An end-user is your customer as Capitis sees them — an opaque record you own, referenced by your own external ID.

POST /v1/end-users

2. Attach a hashed identifier

Hash the identifier with your own salt before you send it. Capitis stores the digest and never the value. Attach as many rails as you have.

POST /v1/end-users/:id/identifiers

3. Issue a tracked link

The response carries a click token. Every conversion that follows references it, so attribution is deterministic rather than modelled.

POST /v1/links

Note

Sandbox click tokens expire after 30 days and resolve against seeded merchants only. Production keys require manual approval while Capitis is in early access.

RequestcURLNodePython
curl -X POST https://api.capitis.app/v1/links \  -H "Authorization: Bearer $CAPITIS_KEY" \  -H "Content-Type: application/json" \  -d '{    "end_user_external_id": "u_4f2a91c",    "merchant_id": "mch_acme_outfitters",    "campaign": "spring-cashback-2026"  }'
Response201
{  "click_token": "clk_8h3K2pQv9Lm4n0R",  "url": "https://go.capitis.app/8h3K2p",  "merchant_id": "mch_acme_outfitters",  "expires_at": "2026-09-13T09:23:16Z"}