> For the complete documentation index, see [llms.txt](https://integrations.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://integrations.impact.com/brand-api-reference/brand-api-reference-v12/reference/conversions/conversions.md).

# Conversions

## Submit a Conversion

> 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\`.

```json
{"openapi":"3.1.0","info":{"title":"Brand API - Conversions","version":"v12"},"servers":[{"url":"https://api.impact.com"}],"security":[{"basicAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","scheme":"basic","description":"Use your AccountSID as the username and AuthToken as the password."}}},"paths":{"/Advertisers/{AccountSID}/Conversions":{"post":{"summary":"Submit a Conversion","description":"Submits a conversion event for tracking and potential attribution.\nAt a minimum, the request must include an event identifier (`EventTypeId` or `EventTypeCode`), an attribution key (like `ClickId` or `CustomerId`), `EventDate`, `CampaignId`, and `OrderId`.","operationId":"submitConversion","tags":["Conversions"],"parameters":[{"name":"AccountSID","in":"path","required":true,"schema":{"type":"string"},"description":"Your unique Account SID."}],"requestBody":{"description":"The details of the conversion event. Use indexed parameters (e.g., `ItemSku1`, `ItemSku2`) for multiple items.\n\n**Additional required parameters** not captured in the `required` list below:\n- One of `ActionTrackerId`, `EventTypeId`, or `EventTypeCode` is required (event identifier).\n- One of `ClickId`, `CustomerId`, `CustomProfileId`, `CustomClickId`, `PromoCode`, `MediaPartnerId`, `UniqueUrl`, `CallerId`, `GoogAId`, `AndroidId`, `AppleIfa`, or `AppleIfv` is required (attribution key).\n\n**Note on conditional requirements:** Many parameters listed below as *optional* are conditionally required based on what else you submit. For example:\n- Item-level fields (`ItemSku[i]`, `ItemQuantity[i]`, `ItemPrice[i]`, `ItemSubTotal[i]`, etc.) become required when reporting at the item level.\n- `CurrencyCode` is required when monetary fields are provided.\n- Mobile-app fields (`AppleIfa`, `GoogAId`, `AppPackage`, `AppInstallRef`, `PropertyId`) are required for mobile-app install attribution.\n- Call-tracking fields (`PhoneNumber`, `CallerId`, `CountryCode`) are required for call-tracking conversions.\n\nSee each field's description for specific conditional requirements.","required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["CampaignId","EventDate","OrderId"],"properties":{"EventTypeId":{"type":"integer","description":"Unique identifier for the event type (action tracker)."},"EventTypeCode":{"type":"string","description":"Configurable string code for the event type."},"ClickId":{"type":"string","description":"The impact.com generated click ID."},"CustomerId":{"type":"string","description":"Your non-PII unique identifier for the customer."},"CustomProfileId":{"type":"string","description":"Your unique identifier for the website visitor."},"OrderPromoCode":{"type":"string","description":"Promo code used for the order."},"UniqueUrl":{"type":"string","format":"uri","description":"A unique tracking URL assigned to a partner."},"GoogAId":{"type":"string","description":"Google Advertising ID."},"AppleIfa":{"type":"string","description":"Apple ID for Advertising (IDFA)."},"AppleIfv":{"type":"string","description":"Apple ID for Vendors (IDFV)."},"MediaId":{"type":"integer","description":"Force attribution to a specific Partner ID."},"PhoneNumber":{"type":"string","description":"Phone number for call tracking attribution."},"CallerId":{"type":"string","description":"Caller ID for call tracking attribution."},"EventDate":{"type":"string","format":"date-time","description":"The date and time the conversion occurred (ISO 8601)."},"CampaignId":{"type":"integer","description":"The unique identifier for your program/campaign."},"OrderId":{"type":"string","description":"Your unique identifier for the order."},"OrderDiscount":{"type":"number","format":"decimal","description":"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."},"OrderSubTotalPostDiscount":{"type":"number","format":"decimal","description":"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."},"OrderShipping":{"type":"number","format":"decimal","description":"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."},"OrderTax":{"type":"number","format":"decimal","description":"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."},"OrderMargin":{"type":"number","format":"decimal","description":"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."},"OrderDiscountRate":{"type":"number","format":"decimal","description":"The discount rate (%) applied to the order."},"CurrencyCode":{"type":"string","description":"3-character ISO 4217 currency code of the purchase."},"Amount":{"type":"number","format":"decimal","description":"This is the total order sale amount made on an item or order level of the conversion."},"GiftPurchase":{"type":"boolean","description":"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."},"PaymentType":{"type":"string","description":"This method of payment used for this conversion (e.g. Credit)."},"ItemSku[i]":{"type":"string","description":"SKU for the item (e.g., ItemSku1, ItemSku2)."},"ItemPromoCode[i]":{"type":"string","description":"Promotional code applied to the item for the order. Note that this parameter does not work with unique tracking codes setup for particular partners."},"ItemName[i]":{"type":"string","description":"The name for the product referenced. Can also be automatically appended through uploading a product catalog."},"ItemCategory[i]":{"type":"string","description":"Category of the item."},"ItemSubCategory[i]":{"type":"string","description":"If applicable, the subcategory for the product referenced at the item level. Can also be automatically pulled if a product catalog has been uploaded."},"ItemMpn[i]":{"type":"string","description":"Manufacturer part number (MPN) for the product referenced. Can also be automatically pulled if a product catalog has been uploaded."},"ItemBrand[i]":{"type":"string","description":"Brand name for the product referenced. Can also be automatically pulled if a product catalog has been uploaded."},"ItemPrice[i]":{"type":"number","format":"decimal","description":"Unit price for the item. Do not send if ItemSubTotal[i] is passed."},"ItemSubTotal[i]":{"type":"number","format":"decimal","description":"Total price for the line item. Do not send if `ItemPrice[i]` is passed."},"ItemQuantity[i]":{"type":"integer","description":"Number of units for this line item."},"ItemDiscount[i]":{"type":"number","format":"decimal","description":"Discount applied to each item purchased of this type (not to the entire line item)."},"ItemDiscountRate[i]":{"type":"number","format":"decimal","description":"The discount rate (%) applied to each item purchased."},"ItemTotalDiscount[i]":{"type":"number","format":"decimal","description":"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."},"ItemDeliveryType[i]":{"type":"string","description":"Type of delivery method specified for this item (e.g. INSTORE)."},"CustomerEmail":{"type":"string","description":"Customer's email address (plain text or SHA1 hashed)."},"CustomerStatus":{"type":"string","description":"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."},"CustomerCity":{"type":"string","description":"City of the customer, such as Santa Barbara."},"CustomerRegion":{"type":"string","description":"Region of the customer, such as AMER."},"CustomerCountry":{"type":"string","description":"Country of the customer, such as USA."},"CustomerPostCode":{"type":"string","description":"Postal (or \"ZIP\") code of the customer, such as 93101."},"IpAddress":{"type":"string","description":"Customer's IP address. Used for fraud detection and install attribution."},"UserAgent":{"type":"string","description":"User agent of the customer, used to provide device reporting."},"DeviceMfr":{"type":"string","description":"Mobile device's manufacturer. Pass `android.os.Build.MANUFACTURER` on Android or `\"Apple\"` on iOS."},"DeviceModel":{"type":"string","description":"Mobile device's model. Pass `android.os.Build.MODEL` on Android or the value from `systemInfo.machine` on iOS."},"PropertyId":{"type":"integer","description":"For mobile app conversions, this value is the \"System App ID\" of your app in impact.com. Found in Settings → Mobile Apps."},"AppPackage":{"type":"string","description":"Package name for the mobile app the user installed. Only for mobile conversions. Note that this is also picked up through the PropertyId field."},"AppInstallRef":{"type":"string","description":"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}."},"AppVer":{"type":"string","description":"Version of the mobile app. Only for mobile conversions."},"LocationId":{"type":"string","description":"Primarily used for accommodations, this is the unique identifier for the location specified in this conversion."},"LocationName":{"type":"string","description":"Primarily used for accommodations, this is the name for the location specified in this conversion."},"LocationType":{"type":"string","description":"Primarily used for accommodations, this is the category for the location specified in this conversion."},"TrackingConsent":{"type":"boolean","description":"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."},"Note":{"type":"string","description":"General field used to pass information for event-level reporting purposes."},"DispositionCode":{"type":"string","description":"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."},"Text1–Text50":{"type":"string","description":"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."},"Numeric1":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric2":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric3":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric4":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric5":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric6":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric7":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric8":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric9":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Numeric10":{"type":"number","description":"General numeral field that accepts strings of any numeric data you want to send. Appears in your reports."},"Money1":{"type":"number","description":"General numeral field that accepts strings of any money or financial data you want to send. Appears in your reports."},"Money2":{"type":"number","description":"General numeral field that accepts strings of any money or financial data you want to send. Appears in your reports."},"Money3":{"type":"number","description":"General numeral field that accepts strings of any money or financial data you want to send. Appears in your reports."},"Date1":{"type":"string","description":"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."},"Date2":{"type":"string","description":"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."},"Date3":{"type":"string","description":"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."},"Date4":{"type":"string","description":"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."},"Date5":{"type":"string","description":"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."},"Date6":{"type":"string","description":"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."},"Date7":{"type":"string","description":"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."},"Date8":{"type":"string","description":"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."},"Date9":{"type":"string","description":"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."},"Date10":{"type":"string","description":"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."},"ItemText[i]_1":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_2":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_3":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_4":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_5":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_6":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_7":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_8":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_9":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemText[i]_10":{"type":"string","description":"General text field that accepts strings of any text data for a SKU."},"ItemNumeric[i]_1":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_2":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_3":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_4":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_5":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_6":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_7":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_8":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_9":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemNumeric[i]_10":{"type":"number","description":"General numeral field that accepts strings of any numeric data for a SKU."},"ItemMoney[i]_1":{"type":"number","description":"General numeral field that accepts strings of any money or financial data for a SKU."},"ItemMoney[i]_2":{"type":"number","description":"General numeral field that accepts strings of any money or financial data for a SKU."},"ItemMoney[i]_3":{"type":"number","description":"General numeral field that accepts strings of any money or financial data for a SKU."},"ItemDate[i]_1":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_2":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_3":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_4":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_5":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_6":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_7":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_8":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_9":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."},"ItemDate[i]_10":{"type":"string","description":"General date field that accepts a date or datetime for a SKU."}}}}}},"responses":{"200":{"description":"The conversion event was successfully queued for processing.","content":{"application/json":{"schema":{"type":"object","properties":{"Status":{"type":"string"},"QueuedUri":{"type":"string","format":"uri-reference"}}}}}},"400":{"description":"Bad Request. The request was invalid due to missing or malformed parameters.","content":{"application/json":{"schema":{"type":"object","properties":{"Status":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"level":{"type":"string"},"message":{"type":"string"}}}}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://integrations.impact.com/brand-api-reference/brand-api-reference-v12/reference/conversions/conversions.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.