Conversions

Submit a Conversion

post

Submits a conversion event for tracking and potential attribution. At a minimum, the request must include an event identifier (EventTypeId or EventTypeCode), an attribution key (like ClickId or CustomerId), EventDate, CampaignId, and OrderId.

Authorizations

AuthorizationstringRequired

Use your AccountSID as the username and AuthToken as the password.

Path parameters

AccountSIDstringRequired

Your unique Account SID.

Body

EventTypeIdintegerOptional

Unique identifier for the event type (action tracker).

Example: 8180

EventTypeCodestringOptional

Configurable string code for the event type.

Example: ACME_SALE

ClickIdstringOptional

The impact.com generated click ID.

Example: QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0

CustomerIdstringOptional

Your non-PII unique identifier for the customer.

Example: BCZ2WVSH674563PDPYOTM3AXDQ

CustomProfileIdstringOptional

Your unique identifier for the website visitor.

Example: a1b2c3d4e5f6

OrderPromoCodestringOptional

Promo code used for the order.

Example: 10OFF-ROCKET

UniqueUrlstring · uriOptional

A unique tracking URL assigned to a partner.

GoogAIdstringOptional

Google Advertising ID.

Example: 38400000-8cf0-11bd-b23e-10b96e40000d

AppleIfastringOptional

Apple ID for Advertising (IDFA).

Example: 38400000-8cf0-11bd-b23e-10b96e40000d

AppleIfvstringOptional

Apple ID for Vendors (IDFV).

Example: 38400000-8cf0-11bd-b23e-10b96e40000d

MediaIdintegerOptional

Force attribution to a specific Partner ID.

Example: 10000

PhoneNumberstringOptional

Phone number for call tracking attribution.

Example: 8051234567

CallerIdstringOptional

Caller ID for call tracking attribution.

Example: 8051234567

EventDatestring · date-timeRequired

The date and time the conversion occurred (ISO 8601).

Example: 2026-09-10T22:55:32-08:00

CampaignIdintegerRequired

The unique identifier for your program/campaign.

Example: 3641

OrderIdstringRequired

Your unique identifier for the order.

Example: 9217374917471

OrderDiscountnumber · decimalOptional

For sales, this is the discount applied to the order overall. Amount is automatically subtracted from the order total on processing. If item amounts are used, this discount will be subtracted proportionally from each item amount sent in. Note that typically you will want to exclude shipping discounts from this field.

Example: 5

OrderSubTotalPostDiscountnumber · decimalOptional

Used when reporting conversions at the order-level (i.e., no item reporting). The subtotal of the order after discounts, taxes, shipping, and any other costs. If you're submitting item-level data, this value should not be submitted.

Example: 95

OrderShippingnumber · decimalOptional

Primarily used for retail sales. This is the cost of shipping for this conversion. Note that the total sale amount used for payout purposes will not include shipping costs.

Example: 5

OrderTaxnumber · decimalOptional

Primarily used for retail sales. This is the cost of tax for this conversion. Note that the total sale amount used for payout purposes will not include shipping costs.

Example: 8

OrderMarginnumber · decimalOptional

Primarily used for retail sales. This is the total margin made on the conversion (revenue less costs). Typically this is provided either at an item level through the ItemMargin field or through the product catalog.

Example: 30

OrderDiscountRatenumber · decimalOptional

The discount rate (%) applied to the order.

Example: 10

CurrencyCodestringOptional

3-character ISO 4217 currency code of the purchase.

Example: USD

Amountnumber · decimalOptional

This is the total order sale amount made on an item or order level of the conversion.

Example: 123

GiftPurchasebooleanOptional

If you're tracking gift purchases, you can submit true to mark the order in the conversion as a gift purchase. Submit false if the order isn't a gift purchase.

Example: false

PaymentTypestringOptional

This method of payment used for this conversion (e.g. Credit).

Example: CREDIT_CARD

ItemSku[i]stringOptional

SKU for the item (e.g., ItemSku1, ItemSku2).

ItemPromoCode[i]stringOptional

Promotional code applied to the item for the order. Note that this parameter does not work with unique tracking codes setup for particular partners.

Example: 10OFF-ACME

ItemName[i]stringOptional

The name for the product referenced. Can also be automatically appended through uploading a product catalog.

ItemCategory[i]stringOptional

Category of the item.

ItemSubCategory[i]stringOptional

If applicable, the subcategory for the product referenced at the item level. Can also be automatically pulled if a product catalog has been uploaded.

Example: Tennis

ItemMpn[i]stringOptional

Manufacturer part number (MPN) for the product referenced. Can also be automatically pulled if a product catalog has been uploaded.

Example: ACME-MPN-101

ItemBrand[i]stringOptional

Brand name for the product referenced. Can also be automatically pulled if a product catalog has been uploaded.

Example: Acme

ItemPrice[i]number · decimalOptional

Unit price for the item. Do not send if ItemSubTotal[i] is passed.

ItemSubTotal[i]number · decimalOptional

Total price for the line item. Do not send if ItemPrice[i] is passed.

ItemQuantity[i]integerOptional

Number of units for this line item.

ItemDiscount[i]number · decimalOptional

Discount applied to each item purchased of this type (not to the entire line item).

Example: 1

ItemDiscountRate[i]number · decimalOptional

The discount rate (%) applied to each item purchased.

Example: 10

ItemTotalDiscount[i]number · decimalOptional

Discount applied to this line item (not just for each product of this type). Note that this amount is automatically subtracted from the ItemSubTotal to determine the final sale amount for payout and reporting purposes.

Example: 5

ItemDeliveryType[i]stringOptional

Type of delivery method specified for this item (e.g. INSTORE).

Example: INSTORE

CustomerEmailstringOptional

Customer's email address (plain text or SHA1 hashed).

Example: customer@gmail.com

CustomerStatusstringOptional

Status of the customer, such as NEW or EXISTING. Before being passed, values must be configured in the Customer Status Mapping section when editing an event type, found in the event type settings section of the platform.

Example: NEW

CustomerCitystringOptional

City of the customer, such as Santa Barbara.

CustomerRegionstringOptional

Region of the customer, such as AMER.

CustomerCountrystringOptional

Country of the customer, such as USA.

CustomerPostCodestringOptional

Postal (or "ZIP") code of the customer, such as 93101.

IpAddressstringOptional

Customer's IP address. Used for fraud detection and install attribution.

Example: 72.194.216.61

UserAgentstringOptional

User agent of the customer, used to provide device reporting.

Example: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36

DeviceMfrstringOptional

Mobile device's manufacturer. Pass android.os.Build.MANUFACTURER on Android or "Apple" on iOS.

Example: Apple

DeviceModelstringOptional

Mobile device's model. Pass android.os.Build.MODEL on Android or the value from systemInfo.machine on iOS.

Example: iPhone 15

PropertyIdintegerOptional

For mobile app conversions, this value is the "System App ID" of your app in impact.com. Found in Settings → Mobile Apps.

Example: 12345

AppPackagestringOptional

Package name for the mobile app the user installed. Only for mobile conversions. Note that this is also picked up through the PropertyId field.

Example: com.acme.app

AppInstallRefstringOptional

Only for Android conversions. Install referrer passed from the Google Play Store when the app is installed. Usually, the value passed from impact.com tracking links will be clickid={clickidvalue}.

Example: clickid=QiiWXOVnrQ3SQHl24jQjyxBGUkmzfJ3i1VHrWM0

AppVerstringOptional

Version of the mobile app. Only for mobile conversions.

Example: 1.2.3

LocationIdstringOptional

Primarily used for accommodations, this is the unique identifier for the location specified in this conversion.

Example: LOC-12345

LocationNamestringOptional

Primarily used for accommodations, this is the name for the location specified in this conversion.

Example: Acme Resort Santa Barbara

LocationTypestringOptional

Primarily used for accommodations, this is the category for the location specified in this conversion.

Example: HOTEL

TrackingConsentbooleanOptional

Indicates whether the user has provided consent to be tracked at the moment of the request. Derived from your consent management platform or through frameworks like Apple's ATT (App Tracking Transparency) available on iOS.

Example: true

NotestringOptional

General field used to pass information for event-level reporting purposes.

Example: Customer confirmed delivery.

DispositionCodestringOptional

If you have a custom disposition code configured in event type settings, you can submit that value as a default disposition for the action that results from this conversion.

Example: DEFAULT

Text1–Text50stringOptional

General text field that accepts strings of any text data you want to send. Appears in your reports. There are 50 of these fields, from Text1 to Text50.

Example: text1value

Numeric1numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 100.5

Numeric2numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 20

Numeric3numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 30

Numeric4numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 40

Numeric5numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 50

Numeric6numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 60

Numeric7numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 70

Numeric8numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 80

Numeric9numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 90

Numeric10numberOptional

General numeral field that accepts strings of any numeric data you want to send. Appears in your reports.

Example: 100

Money1numberOptional

General numeral field that accepts strings of any money or financial data you want to send. Appears in your reports.

Example: 50

Money2numberOptional

General numeral field that accepts strings of any money or financial data you want to send. Appears in your reports.

Example: 50

Money3numberOptional

General numeral field that accepts strings of any money or financial data you want to send. Appears in your reports.

Example: 75

Date1stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-03-28

Date2stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-05-21T07:25:00Z

Date3stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-03-28

Date4stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-05-21T07:25:00Z

Date5stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-03-28

Date6stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-05-21T07:25:00Z

Date7stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-03-28

Date8stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-05-21T07:25:00Z

Date9stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-03-28

Date10stringOptional

Field that accepts a date string, for example "2026-03-28", or a datetime string, for example "2026-05-21T07:25:00Z". Appears in your reports.

Example: 2026-05-21T07:25:00Z

ItemText[i]_1stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-1

ItemText[i]_2stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-2

ItemText[i]_3stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-3

ItemText[i]_4stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-4

ItemText[i]_5stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-5

ItemText[i]_6stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-6

ItemText[i]_7stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-7

ItemText[i]_8stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-8

ItemText[i]_9stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-9

ItemText[i]_10stringOptional

General text field that accepts strings of any text data for a SKU.

Example: item-text-10

ItemNumeric[i]_1numberOptional