Help Center

| Submit or View Help Requests | Developer Docs |

View desktop instructions
View mobile app instructions
Modify or Reverse Items in an Action via API

In addition to modifying and reversing actions, impact.com allows you to modify and reverse the item-level details of an action.

Note

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

Modify items in an action via API

If you're tracking at the item level (i.e., passing item data when reporting conversions), you can use the API to modify the quantity or reported revenue amount of items within an action.

To modify items in an action, you'll need:

  • The ActionId of the action.

  • The Reason for updating the action (when modifying items in action, always submit ORDER_UPDATE).

  • The Sku of the item(s) to be modified (can be found when retrieving an action via API).

  • The new Quantity value for the item.

  • The new revenue Amount value for the item — only include this in the call if this value is changing (e.g., the reported item revenue amount was reported incorrectly).

Once you have all these values, see the example calls below to learn how to modify an item within an action.

Example calls & response

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 'ActionId={ActionId}' \
-d 'Sku={Sku}' \
-d 'Quantity={Quantity}' \
-d 'Reason=ORDER_UPDATE' \
Example response

{  "Status": "QUEUED",  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"}
Parameter reference

AccountId

Your impact.com account's API account ID value. Learn how to find this value.

AuthToken

Your impact.com account's API authorization token value. Learn how to find this value.

ActionId

The ID value of the action to be modified.

Sku

The stock-keeping unit value of the item — this can be found when retrieving an action via API.

Quantity

The new quantity value for the item.

Reason

When reversing or modifying an item, always submit ORDER_UPDATE as the reason.

Amount

The new revenue amount value for the item.

Reverse items in an action via API

If you're tracking at the item-level (i.e., passing item data when reporting conversions), you can use the API to reverse one or more item by setting Quantity to 0.

To reverse items in an action, you'll need:

  • The ActionId of the action.

  • The Reason for updating the action (when reversing items in action, always submit ORDER_UPDATE).

  • The Sku of the item(s) to be reversed (can be found when retrieving an action via API).

  • The new Quantity value for the item — in this case, 0

Once you have all of these values, see the example call below to learn how to reverse items in an action.

Example call & response

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 'ActionId={ActionId}' \  -d 'Sku={Sku}' \
-d 'Quantity=0' \
-d 'Reason=ORDER_UPDATE'
Example response

{  "Status": "QUEUED",  "QueuedUri": "/Advertisers/{AccountSID}/APISubmissions/A-86b9-56992f50eefe"}  
Parameter reference

AccountId

Your impact.com account's API account ID value. Learn how to find this value.

AuthToken

Your impact.com account's API authorization token value. Learn how to find this value.

ActionId

The ID value of the action to be modified.

Sku

The stock-keeping unit value of the item — this can be found when retrieving an action via API.

Quantity

The new quantity value for the item.

Reason

When reversing or modifying an item, always submit ORDER_UPDATE as the reason.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.