Ingest

Create a conversion

Requires conversion.create. X-Api-Key is required; sessions are not accepted. Omit projectId only when the key is restricted to exactly one project; global and multiple-project keys must provide it. X-Team-Id is unnecessary and must match the key team when supplied. Value accepts numeric coercion and is rounded to two decimals, then converted into the project currency. An omitted source currency defaults to BRL. Missing transactionId, paymentMethod and visitorId read back as empty strings. Status defaults to paid. A repeated nonempty transactionId with the same status returns DUPLICATE_CONVERSION (409).

POST

conversions

A valid request URL is required to generate request examples

{
  "id": "11111111-1111-4111-8111-111111111111",
  "timestamp": "2026-06-01 12:00:00.000",
  "transactionId": "order-example-1",
  "value": 49.9,
  "currency": "BRL",
  "paymentMethod": "pix",
  "status": "paid",
  "visitorId": "visitor-example-1"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "errors": {}
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Authorizations

X-Api-Key

string

header

required

Body

application/json

value

number

required

projectId

string<uuid>

transactionId

string

currency

string

paymentMethod

string

status

enum<string>

default:paid

Available options:

paid,

pending

string

userAgent

string

visitorId

string

trafficSource

string

utmSource

string

utmMedium

string

utmCampaign

string

utmTerm

string

utmContent

string

clickId

string

sub1

string

sub2

string

sub3

string

sub4

string

sub5

string

sub6

string

sub7

string

sub8

string

Response

Created conversion.

string

required

timestamp

string

required

ClickHouse UTC timestamp, for example 2026-06-01 12:00:00.000.

transactionId

string

required

value

number

required

currency

string

required

paymentMethod

string

required

status

enum<string>

required

Available options:

paid,

pending

visitorId

string

required

A valid request URL is required to generate request examples

{
  "id": "11111111-1111-4111-8111-111111111111",
  "timestamp": "2026-06-01 12:00:00.000",
  "transactionId": "order-example-1",
  "value": 49.9,
  "currency": "BRL",
  "paymentMethod": "pix",
  "status": "paid",
  "visitorId": "visitor-example-1"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "errors": {}
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Projects

Conversions

Refunds

Chargebacks

Visitors

Requests

Analytics

Dashboards

Pixels

Triggers

Trigger logs

Links

Pages

Domains

Firewall rules

Sales platforms

Traffic sources

Assets

URLs

Ads manager

Ingest

Create a conversion

Authorizations

Body

Response