API: tracking links, domains, pixels and stats

A tracking link sends a visitor to a creator on Telegram and counts what follows: clicks, conversations, first messages, buyers and revenue. Links can live on your own domain, fire ad pixels (Meta, TikTok, Snap) and send server events. These endpoints match the Tracking page.

Endpoints #

The link object #

{
  "id": "lnk_3",
  "name": "TikTok · Lea night",
  "slug": "lea-tiktok-night",
  "creator_id": "cr_lea",
  "source": "tiktok",
  "campaign": "Autumn",
  "domain": "go.mia-links.com",
  "public_url": "https://go.mia-links.com/r/lea-tiktok-night",
  "destination": "pool",
  "account_id": null,
  "utm": { "source": "tiktok", "medium": "social", "campaign": "autumn" },
  "pixels": { "meta": false, "tiktok": true, "snap": false },
  "counters": { "clicks": 640, "conversations": 97, "first_messages": 76, "buyers": 14, "revenue_stars": 6200 },
  "archived": false,
  "created_at": "2026-09-12T08:00:00Z"
}

• destination is pool (the account is chosen at click time among the creator's pool, see pools) or account (always the same account_id).
• slug: lowercase letters, digits and dashes, 1 to 48 characters, starting and ending with a letter or a digit, unique among active links of the same domain.
• domain must be a verified domain of the workspace; without it the LanaChat domain is used.
• utm values: up to 80 letters, digits, dots, dashes or underscores. They are stamped on every click and forwarded to pixel events.

The domain object #

{
  "host": "go.mia-links.com",
  "builtin": false,
  "status": "pending",
  "error": null,
  "ssl": "none",
  "is_default": false,
  "label": "Lea TikTok",
  "token": "8be03d5f19a2",
  "checks": 0,
  "added_at": "2026-10-05T10:00:00Z",
  "verified_at": null,
  "last_check_at": null
}

The pixel connection object #

{ "connected": true, "pixel_id": "123456789012345", "token_last4": "x9Qa", "token_status": "valid", "token_error": null, "test_event_code": "TEST4821", "connected_at": "2026-10-06T14:30:00Z" }

The event object #

{
  "id": "evt_purchase",
  "name": "Purchase",
  "builtin": true,
  "trigger": { "type": "purchase" },
  "networks": { "meta": true, "tiktok": true, "snap": false }
}

The stats object #

{
  "days":    [ { "date": "2026-10-05", "clicks": 54, "conversations": 9, "first_messages": 7, "buyers": 2, "revenue_stars": 950 } ],
  "links":   [ { "link_id": "lnk_3", "clicks": 640, "conversations": 97, "first_messages": 76, "buyers": 14, "revenue_stars": 6200 } ],
  "sources": [ { "source": "instagram", "clicks": 1210, "conversations": 160, "first_messages": 131, "buyers": 22, "revenue_stars": 9100 } ]
}

Links #

List links #

GET /links · can_tracking or can_sales_read

curl "https://api.lanachat.ai/v1/links?creator_id=cr_lea&archived=false" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

The answer is a paged list of link objects, each with its counters.

Create a link #

POST /links · can_tracking

curl -X POST https://api.lanachat.ai/v1/links \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name": "Insta bio · Lea", "slug": "lea-bio", "creator_id": "cr_lea", "source": "instagram", "destination": "pool", "domain": "go.mia-links.com"}'

{
  "id": "lnk_9",
  "name": "Insta bio · Lea",
  "slug": "lea-bio",
  "creator_id": "cr_lea",
  "source": "instagram",
  "campaign": null,
  "domain": "go.mia-links.com",
  "public_url": "https://go.mia-links.com/r/lea-bio",
  "destination": "pool",
  "account_id": null,
  "utm": { "source": null, "medium": null, "campaign": null },
  "pixels": { "meta": false, "tiktok": false, "snap": false },
  "counters": { "clicks": 0, "conversations": 0, "first_messages": 0, "buyers": 0, "revenue_stars": 0 },
  "archived": false,
  "created_at": "2026-10-06T14:40:00Z"
}

• A slug already used answers 409 with The slug /lea-bio is already used by "Insta bio · Mia".
• A domain that is not verified answers 400 ("Pick a verified domain…").

Get a link #

GET /links/{id} · can_tracking or can_sales_read

curl https://api.lanachat.ai/v1/links/lnk_3 \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

The answer is the link object. An unknown id answers 404.

Replace a link #

PUT /links/{id} · can_tracking

Same body as Create a link; PUT replaces the whole link, so send every field you want to keep.

curl -X PUT https://api.lanachat.ai/v1/links/lnk_3 \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "TikTok · Lea night", "slug": "lea-tiktok-night", "creator_id": "cr_lea", "source": "tiktok", "campaign": "Autumn", "destination": "pool", "domain": "go.mia-links.com", "utm": {"source": "tiktok", "medium": "social", "campaign": "autumn"}, "pixels": {"meta": false, "tiktok": true, "snap": false}}'

The answer is the updated link. Same errors as when you create one.

Archive or delete a link #

DELETE /links/{id} · can_tracking

curl -X DELETE https://api.lanachat.ai/v1/links/lnk_3 \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

An archived link is left out of stats.

Domains #

To use your own domain, add it, create two DNS records, then verify it:

• CNAME go.mia-links.com → links.lanachat.app
• TXT _lanachat.go.mia-links.com = lanachat-verify=8be03d5f19a2

Pending domains are also checked every 10 minutes for 72 hours, then daily. status becomes verified and ssl goes issuing then active.

List domains #

GET /domains · can_tracking

curl "https://api.lanachat.ai/v1/domains?status=active" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

The answer lists domain objects, the LanaChat domain included (builtin: true).

Add a domain #

POST /domains · can_tracking

curl -X POST https://api.lanachat.ai/v1/domains \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"host": "go.mia-links.com"}'

The answer is the new domain with status: "pending" and its token for the TXT record. The host is cleaned (lowercase, no https://, no path). Root domains, *.lanachat.app and a domain already added answer 400 with a sentence.

Verify a domain #

POST /domains/{host}/verify · can_tracking

curl -X POST https://api.lanachat.ai/v1/domains/go.mia-links.com/verify \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

{ "host": "go.mia-links.com", "builtin": false, "status": "verified", "error": null, "ssl": "issuing", "is_default": false, "label": null, "token": "8be03d5f19a2", "checks": 3, "added_at": "2026-10-05T10:00:00Z", "verified_at": "2026-10-06T14:45:00Z", "last_check_at": "2026-10-06T14:45:00Z" }

When a record is wrong, status is error and error says which, for example "The CNAME record points to another service." The LanaChat domain cannot be verified (its DNS is managed by LanaChat).

Change a domain #

PATCH /domains/{host} · can_tracking

curl -X PATCH https://api.lanachat.ai/v1/domains/go.mia-links.com \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"is_default": true}'

Only a verified domain can be the default. The LanaChat domain refuses a label (403).

Remove a domain #

DELETE /domains/{host} · can_tracking

curl -X DELETE https://api.lanachat.ai/v1/domains/go.mia-links.com \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Removing the LanaChat domain, the default domain ("Set another default domain first") or a domain used by active links ("Used by N active links across all creators") answers 409.

Pixels #

Events are sent server to server, deduplicated with the browser pixel through the same event_id, with the fan's Telegram id hashed (SHA-256), never raw. Without consent no event is sent, ever. A pixel fires only for links that enable it.

Read pixel connections #

GET /pixels · can_tracking

curl https://api.lanachat.ai/v1/pixels \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

The answer holds one pixel connection for each of meta, tiktok and snap, and the consent mode.

Connect a pixel #

PUT /pixels/{provider} · owner

curl -X PUT https://api.lanachat.ai/v1/pixels/meta \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pixel_id": "123456789012345", "access_token": "EAAG…", "test_event_code": "TEST4821"}'

{ "connected": true, "pixel_id": "123456789012345", "token_last4": "x9Qa", "token_status": "valid", "token_error": null, "test_event_code": "TEST4821", "connected_at": "2026-10-06T14:30:00Z" }

The access token is stored encrypted and never returned: only token_last4. A pixel id in the wrong format or an empty token answers 400.

Disconnect a pixel #

DELETE /pixels/{provider} · owner

curl -X DELETE https://api.lanachat.ai/v1/pixels/meta \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Send a test event #

POST /pixels/{provider}/test · can_tracking

curl -X POST https://api.lanachat.ai/v1/pixels/meta/test \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

{ "ok": true, "status": 200, "body": "{\"events_received\":1}" }

status and body are the platform's own answer, so you see exactly what Meta, TikTok or Snap said.

Set the consent mode #

PUT /pixels/consent · owner

curl -X PUT https://api.lanachat.ai/v1/pixels/consent \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "implicit_by_country"}'

Events #

Built-in events: Lead (conversation started from a link), Contact (first fan message), Purchase (verified sale), Subscribe, InitiateCheckout. Custom events take a trigger: sale_over (a sale above an amount in US dollars), tag_added (a tag), nth_message (the Nth fan message, 2 or more) or offer_viewed.

List events #

GET /events · can_tracking

curl https://api.lanachat.ai/v1/events \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

The answer lists event objects with their deliveries accepted and failed over 7 days, per network.

Create a custom event #

POST /events · owner

curl -X POST https://api.lanachat.ai/v1/events \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name": "BigSpender", "trigger": {"type": "sale_over", "value": 50}, "networks": {"meta": true, "tiktok": true, "snap": false}}'

The answer is the new event (201). A name already used answers 409.

Turn an event on or off #

PATCH /events/{id} · owner

curl -X PATCH https://api.lanachat.ai/v1/events/evt_purchase \
  -H "Authorization: Bearer $LANACHAT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"networks": {"meta": true, "tiktok": true, "snap": true}}'

Delete a custom event #

DELETE /events/{id} · owner

curl -X DELETE https://api.lanachat.ai/v1/events/evt_bigspender \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

Built-in events cannot be deleted; turn them off instead.

Stats #

Read stats #

GET /stats · can_sales_read

curl "https://api.lanachat.ai/v1/stats?from=2026-09-06&to=2026-10-05&creator_id=cr_lea" \
  -H "Authorization: Bearer $LANACHAT_TOKEN"

The answer is the stats object. Days are UTC; archived links are left out.

Export stats as CSV #

GET /stats/export.csv · can_sales_read

Same parameters as GET /stats.

curl "https://api.lanachat.ai/v1/stats/export.csv?from=2026-09-06&to=2026-10-05" \
  -H "Authorization: Bearer $LANACHAT_TOKEN" -o stats.csv

date,link,slug,domain,creator,source,clicks,conversations,first_messages,buyers,revenue_stars
2026-10-05,TikTok · Lea night,lea-tiktok-night,go.mia-links.com,Lea,tiktok,54,9,7,2,950