Conversion Tracking

Record a conversion (POST)

Records a conversion for a click from a request body (JSON, form or a sendBeacon string).

Auth: none. The click id is the credential; no cookie or API key is read. CORS is open to every origin.

Plan: no caller plan check. The click's link must have conversion tracking on (a Pro link setting), and the click must be at most 30 days old.

Rate limit: 60 requests per 60 s per client IP, shared by GET and POST on /api/conversion and /api/postback (fixed window, in memory per server instance). The 429 has no Retry-After.

post/api/conversion

Request

  • Base URL: https://www.flyn.to
  • URL: https://www.flyn.to/api/conversion
  • Auth: none required

Query parameters

click_idstring

Per-click id Flyn appended to the destination as flyn_id. Also accepted as clickId, flyn_id, clickid or cid; the first one present wins, so an empty click_id hides a valid cid. On POST, body fields of the same name take precedence.

eventstring

Goal name, trimmed and lower-cased; empty means conversion. Also accepted as type. On POST, body fields of the same name take precedence.

valuestring

Value in major units. Also accepted as payout, sum or amt. Characters other than digits, dot, comma and minus are stripped; a European decimal comma is understood; above 1,000,000 in size or unparseable becomes 0. Stored in cents; a negative value records a refund. On POST, body fields of the same name take precedence.

currencystring

ISO 4217 code, upper-cased; anything but three letters becomes USD. On POST, body fields of the same name take precedence.

txidstring

Transaction id, first 64 characters kept. Also accepted as transaction_id. Part of the (click, event, txid) de-duplication key. On POST, body fields of the same name take precedence.

Request body

click_idstring required

The per-click id Flyn appended to the destination as flyn_id. Also accepted as clickId, flyn_id, clickid or cid (first present wins).

eventstring

Goal name, lower-cased first. Also accepted as type.

currencystring

ISO 4217 code, upper-cased; anything but three letters becomes USD.

txidstring

Transaction id (first 64 characters kept). Also accepted as transaction_id. Part of the (click, event, txid) de-duplication key.

Response

Recorded, or already recorded for this (click, event, txid) (duplicate: true).

okboolean required
duplicateboolean

Present and true when the same (click, event, txid) was already recorded.

errorstring

Present when ok is false.

Changes

No recorded changes to this operation across all 1 revision of this API.