Batch Modify or Reverse via API

Take the PXA course

If anything about an action changes (e.g., an order was canceled, an item was returned, etc.), you can use the API to modify (or reverse) it, changing the commission amount for the action.

Which submission method is 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, push file via FTP, or pull file via FTP

API reversal options:

• Modify or reverse one or more items in an action via API
• Reverse an entire action via API

Prerequisite: Retrieve the ActionId value

To modify action data via API, you'll need its ActionId value. You can then use this to find the action you want to modify via API.

• You can specify a date range in your call — otherwise, the endpoint defaults to showing the last 30 days of actions.
• Rate limits apply.
• View the List all actions API endpoint documentation to learn more.

FAQs

How do I reset a modification / reversal made to an action (or action items)?

If an action has been modified or reversed before its locking date, you can submit RESET as a reason to update the action back to its default state:

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 'Reason=RESET'

Actions that have been reset via the RESET code may not appear correctly in reporting (e.g., revenue values may be calculated incorrectly).

What is the difference between a disposition code & reason?

Both Disposition Codes and Reasons are used in the same context — Reasons are predefined codes that the API will accept by default, whereas Disposition Codes are custom reasons you can configure. Learn more about Disposition Codes.

Supported reason codes:

Code	Description
CONS_FRAUD	Consumer fraud
CONS_ERROR	Consumer error
ITEM_RETURNED	Item was returned
APPROVED	Action is approved Note: If you’re trying to approve actions, Approve needs to be set up as a custom disposition code.
ORDER_ERROR	Order error
ORDER_UPDATE	Order was updated
PUB_ACT_DISPUTE	Partner activity dispute
ADV_ACT_DISPUTE	Brand activity dispute
NOT_COMPLIANCE_TERMS	Not in compliance with terms
ITEM_OUT_OF_STOCK	Item is out of stock
TEST_ACTION	Test action
PARTNER_NOT_ACTIVE	Partner account deactivated
CREDITED_DIFFERENT_MP	Credited to another partner
OTHER	Other reason

How can I see when modifications / reversals are applied to an action?

You can use the action updates endpoint to see when an action was last updated and what its current state is.

Note: An ActionUpdatesID value is different from an ActionId value — you must use the ActionUpdatesID value to retrieve updates for an action.