Skip to main content
POST
Create a conversion goal

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Body

application/json
name
string
required
Required string length: 1 - 160
type
enum<string>
required
Available options:
pixel_fire,
webhook_hit,
manual,
tag_added,
custom_event
config
object

Type-specific configuration.

value_cents
integer | null

Monetary value credited per conversion, in minor units.

Required range: x >= 0
lookback_days
integer
default:7

Attribution lookback window in days.

Required range: 1 <= x <= 180
attribution_model
enum<string>
default:last_touch
Available options:
last_touch,
first_touch,
linear,
time_decay
enabled
boolean
default:true

Response

201 - application/json

The created goal.

data
object

A conversion goal configured for the tenant, with its attribution settings and (for pixel_fire goals) a signed pixel URL hint. Batched all-time conversion/revenue totals are populated only on the goals list endpoint.

meta
object