Integration Solutions


Loop offers API + Webhook integration solutions to allow our merchants to integrate critical aspects of their business, making it easier to manage, automate, and reconcile returns and exchanges.
Please contact to request webhook setup, API access, and/or additional documentation.

Receiving Returns Data

The primary data flow for every integration involves sending or pulling returns information from Loop into third party systems/software.
Loop offers both Webhooks + our Returns API for receiving returns data.


Each time a customer initiates a return, a Loop webhook will deliver details of the return to a pre-defined endpoint. This data can be leveraged to create a record (RA, RMA, etc) in a third party system. Subscribers can choose to receive webhooks upon the creation of a return, when the return status has been changed, or both.

Returns API 

In some cases, it’s best to pull returns from Loop on a recurring basis. This can be done using either of two endpoints, each delivering varying fidelities of returns data during a specified period (date parameters):

API responses can be found in the documentation above. 

Processing Returns 

Often, returns are automatically processed using carrier events such as “in_transit” or “delivered”. When this is not the case, and returns are being processed manually after returning to the warehouse, the Warehouse API can be leveraged to automate these actions.

There are three actions that can be taken via the API:

  1. Process return
  2. Flag return
  3. Cancel return 

Process Return

When a return has met merchant criteria and is approved, hitting the Process Return endpoint will process the return and execute the customer’s requested outcome in Shopify. 

Flag Return

Returns that require additional action can be flagged via the Flag Return endpoint. These returns will be sent to the “Needs Review” section of the Loop admin and can be actioned on a case by case basis by the merchant. 

Cancel Return

Although typically actioned manually by the merchant to handle edge cases, the Cancel Return endpoint can be leveraged to cancel a return within Loop. 

Note: The customer will have the ability to resubmit a return or exchange that has been cancelled until the Return Window closes.


1. Can I send custom parameters through the flag endpoint?

Currently, no. However, this functionality will be included in future API enhancements

Please contact to request webhook setup, API access, and/or additional documentation.