Is this submission method right for you?

If you want to...	Use this method...
Submit a manual, one-time file with no coding	Email batch processing or upload file via FTP
Set up automated conversion reporting	Conversions / Actions API or pull file via FTP

Updates one of the line-items for an action by setting the values of the parameters passed. You can also make these updates to multiple line-items in a single API call. Use this endpoint to update any of the item-level details for the action, such as Quantity and Amount. This endpoint supports two modes, absolute and relative, where you can either specify the new quantity for this item or the change in quantity from the current value. Note that actions can be specified either by using the impact.com's unique identifier for the action (i.e., ActionId) or by using a combination of your identifier (i.e., OrderId) and the type of event (i.e., EventType).

If you want to reverse an action, use the reverse action endpoint.

Note: impact.com allows a maximum of 1,000 modifications per action. If you need to make further modifications thereafter, contact support.

Parameters

`ActionId` required, unless using `ActionTrackerId` and `OrderId` together

Unique identifier for the action, used to specify which action you intend to reverse. Passing the ActionId can be used instead of sending ActionTrackerId and OrderId.

`ActionTrackerId` optional if using `ActionId`, required with `OrderId`

Unique identifier for the action tracker (or event type) that tracked the action.

`OrderId` optional if using `ActionId`, required if using `ActionTrackerId`

Your unique identifier for the order ID associated with the conversion in the action.

`Sku` required

Stock-keeping unit value of the action item to update.

`Reason` required

Always submit ORDER_UPDATE as the reason for an item-level update.

`Quantity` required

Set the quantity of an item. If an item was returned, submit 0 as the quantity.

`Amount` conditionally required

Required for modifications and reversals. Set to 0 for reversals, unless the original Amount = 0.

Set the revenue amount for the action item. This represents the final value and does not accept relative inputs. Changing this value will affect the Payout value (a new payout is calculated according to the contract using the new Amount you submit).

`Category` optional

Optional for item-level modifications. Do not include this parameter for reversals.

Set the category for the action item.

More attributes

More attributes

`ItemName` optional

Set the display name of the action item.

`Rebate` optional

Set the discount amount for the action item.

`ItemSubTotalDelta` optional

Specify the delta amount to increase or decrease the SaleAmount value for an action item. Instead of submitting Amount, you can use a positive value (e.g., 50) to increase the SaleAmount value by that number, or a negative value (e.g., "-50") to decrease the SaleAmount by that value.

Returns

The status of the request made and the URI of the API submission on both a single item and bulk item call.

Example request for single item changes

curl 'https://api.impact.com/Advertisers/<AccountSID>/Actions' \
	-X PUT \
	-u '<AccountSID>:<AuthToken>' \
	-H 'Accept: application/json' \
	-H 'Content-Type: application/x-www-form-urlencoded' \
	-d 'Oid=9217374917472' \
	-d 'ActionTrackerId=2240' \
	-d 'Sku=12345' \
	-d 'Quantity=2' \
	-d 'Amount=3.49' \
	-d 'Reason=ORDER_UPDATE'

Example response

{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/<AccountSID>/APISubmissions/A-4632dba3-2211-4615-a62d-6e121ddcdfa1"
}

Example request for bulk item updates

curl 'https://api.impact.com/Advertisers/<AccountSID>/Actions' \
	-X PUT \ 
  	-u '<AccountSID>:<AuthToken>' \ 
  	-H 'Accept: application/json' \ 
  	-H 'Content-Type: application/x-www-form-urlencoded' \ 
  	-H 'Authorization: Basic' \ 
  	-d 'Oid=9217374917472' \ 
  	-d 'ActionTrackerId=2240' \ 
  	-d 'Sku=TestSku1001' \ 
  	-d 'Quantity=1' \ 
    	-d 'Amount1=0' \
    	-d 'Reason=ORDER_UPDATE' \ 
    	-d 'Sku2=TestSku1002' \ 
    	-d 'Quantity=2' \ 
  	-d 'Amount2=0' \ 
  	-d 'Reason=ORDER_UPDATE' \ 
  	-d 'Sku3=TestSku1003' \ 
  	-d 'Quantity=3' \ 
  	-d 'Amount3=0' \ 
  	-d 'Reason=ORDER_UPDATE' \

Example response

{
  "Status": "QUEUED",
  "QueuedUri": "/Advertisers/<AccountSID>/APISubmissions/A-69233608-78c8-401c-be7c-5537632ddc9e"
}