Skip to main content
POST
Report a conversion against one of the workspace's links

Authorizations

Authorization
string
header
required

utmk_, minted on /tokens

Body

application/json

Conversion input

One result the customer's server reports (spec 046). link is the _link value the landing URL carried and is required on a customer's first conversion; afterwards the binding answers.

customer_id
string
required

The customer's identifier in the caller's own system

Required string length: 1 - 128
event_id
string
required

The caller's identifier for this event; a repeat is a retry

Required string length: 1 - 128
currency
string | null

Three letters, shape only; kept as given, never converted

kind
string | null

purchase, signup, lead, or a word of the customer's own

Maximum string length: 32

<host>/<short_code>, exactly the _link value the landing URL carried

occurred_at
string<date-time> | null

When it happened. Defaults to now; refused far in the future or past

value
string | null

Decimal string, >= 0. Requires currency

Pattern: ^\d+(\.\d+)?$

Response

Conversion (a retry, already recorded)

A recorded conversion. attributed_by says how the link was found on a 201; duplicate: true marks the 200 a retry gets.

attributed_by
enum<string> | null
Available options:
reference,
binding
currency
string | null
customer_id
string
duplicate
boolean | null
event_id
string
id
integer
kind
string
occurred_at
string<date-time>
value
string | null