Skip to main content
POST
/
api
/
v1
/
businesses
/
{businessId}
/
conversions
/
entries
Error
A valid request URL is required to generate request examples
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "businessId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "sourceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "contactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "eventValue": 123,
    "currency": "USD",
    "expense": 123,
    "occurredAt": "2023-11-07T05:31:56Z",
    "createdAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key prefixed with sk-ak-. Pass as Authorization: Bearer sk-ak-...

Path Parameters

​
businessId
string<uuid>
required

The business ID

Body

application/json

Entry data

Create a conversion entry. Two modes:

Direct mode: Pass eventValue, currency, expense directly.

Mapped mode: Pass a data object with raw key-value pairs. The source's fieldMappings (configured in the dashboard) automatically maps incoming keys to:

  • Entry fields (eventValue, currency, expense, occurredAt)
  • Contact fields (email, phone, firstName, lastName, etc.)
  • Custom fields (any custom field key defined for the business)

Both modes can be combined — direct values are used as fallbacks if mapping doesn't produce a value.

​
sourceId
string<uuid>
required

The conversion source to send the entry to

​
contactId
string<uuid>
required

The contact this conversion belongs to

​
eventValue
number

Direct conversion value (used when not using field mappings)

Required range: x >= 0
​
currency
string
default:USD

ISO 4217 currency code

Required string length: 3
​
expense
number

Cost/expense associated with this conversion

Required range: x >= 0
​
occurredAt
string<date-time>

When the conversion occurred (defaults to now)

​
data
object

Raw data object with key-value pairs. Keys are your source-side field names (e.g., 'order_total', 'customer_email'). The source's fieldMappings translates these to internal fields automatically.

Example:
{
  "order_total": "499.99",
  "order_currency": "EUR",
  "customer_email": "john@example.com",
  "customer_phone": "+1234567890",
  "company_size": "50-100"
}

Response

Entry created

​
data
object