Bulk-import conversions from CSV text, or manually enter a single one — columns/fields: subid/click_id, status, payout, currency, tid, date

POST

/api/v1/conversions/import

curl --request POST \
  --url https://example.com/api/v1/conversions/import \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "csv": "example", "row": { "clickId": "550e8400-e29b-41d4-a716-446655440000", "status": "sale", "payout": "49.99", "currency": "USD", "tid": "aff-net-12345", "date": "2026-02-14" }, "goalKey": "purchase" }'

Authorizations

• bearer

Request Body^required

Media typeapplication/json

object

csv

Raw CSV text with a header row — columns: subid/click_id, status, payout, currency, tid, date. Mutually exclusive with row.

CSV is sent as text in the JSON body, not multipart/form-data.

string

row

Single manual conversion row — alternative to csv for entering one conversion at a time.

object

clickId

string

Example

550e8400-e29b-41d4-a716-446655440000

status

string

Example

sale

payout

object

Example

49.99

currency

string

Example

USD

tid

string

Example

aff-net-12345

date

string

Example

2026-02-14

goalKey

Goal key applied to every row that maps to a conversion — omitted rows fall back to the click’s owner’s first active goal.

string

Example

purchase

Responses

201

Import report: accepted/rejected counts + per-row detail