Skip to main content
POST
Record a landing page conversion

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Headers

Idempotency-Key
string

Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.

Required string length: 1 - 255
X-Test-Mode
enum<string>

Sandbox opt-in for Clerk-session-authenticated requests — see Test mode explained for the full credential-header matrix and worked samples. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.

Available options:
true,
false

Path Parameters

code
string
required

Body

application/json
kind
enum<string>

Conversion kind; defaults to opt_in when omitted.

Available options:
opt_in,
coupon_claim,
cta_click,
custom
Example:

"coupon_claim"

name
string

Submitter's name, stored as conversion metadata.

Maximum string length: 200
Example:

"Ada Lovelace"

email
string

Submitter's email address.

Maximum string length: 320
Example:

"ada@example.com"

phone
string

Submitter's phone number in E.164 form.

Maximum string length: 40
Example:

"+31612345678"

coupon_code
string

Coupon claimed with the conversion.

Maximum string length: 64
Example:

"WELCOME10"

value
string

Decimal-string monetary value of the conversion, up to 4 fraction digits.

Maximum string length: 20
Example:

"49.99"

m
string

Attribution override for the sending message id.

Maximum string length: 128
Example:

"msg_9f2c"

c
string

Attribution override for the campaign id.

Maximum string length: 128
Example:

"cmp_77aa"

ct
string

Attribution override for the campaign type.

Maximum string length: 128
Example:

"sms"

Response

Successful response.