Conversions

Record a conversion

Idempotent on (goal, external_id) — send the same external_id twice and the second call returns the first conversion with duplicate: true, so a retried webhook can never double-count.

Identify the person with whichever of click_id, contact_id, or email you have. click_id is the stx_cid value carried on links in campaign email and stored by the tracking script; it is the strongest signal and skips the lookup entirely. Recording a conversion never creates a contact.

Omit goal to use the account's primary goal.

post/conversions

Request

  • Base URL: https://api.supersendtx.com
  • URL: https://api.supersendtx.com/conversions
  • Auth: HTTP bearer

Request body

goalstring

Goal key. Defaults to the account's primary goal.

goal_idstring
click_idstring

The stx_cid value carried on campaign links.

contact_idstring
emailstring email
value_centsinteger

Amount in minor units (cents). Defaults to the goal's default value. Ignored (stored as 0) on count-only goals: visit, feedback, waitlist, qualify. Named value_cents so 49 cannot be mistaken for $49.

currencystring

3-letter ISO code. Defaults to the goal's currency.

external_idstring

Your own id for this conversion (charge id, order number). Makes the call idempotent for the goal.

occurred_atstring date-time

Defaults to now. Attribution is measured back from this time.

Response

Conversion recorded, or an existing one returned unchanged

duplicateboolean required

True when this external_id was already recorded for the goal — the existing conversion is returned unchanged and nothing was written.

Changes

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