Flexport Integration (Formerly Deliverr)

OVERVIEW

Flexport (formerly Deliverr, part of Shopify Logistics) describes itself as "an American multinational corporation that focuses on supply chain management and logistics." This article describes the integration between Loop and Flexport, how it works, and how to set it up.


In this article:


How it works

The integration between Flexport and Loop is a two-way integration. It takes the following actions:

  • Creates return merchandise authorizations (RMAs) in Flexport when a customer initiates a return through Loop.
  • Sends Loop line item-level information from Flexport when the returned item(s) arrive at the warehouse. Based on this information, Loop will trigger either a Process or a Flag event.

The returns workflow is as follows:

  1. A customer submits a return through Loop.
  2. Flexport polls Loop's Detailed Returns List API.
  3. An RMA is created in Flexport using the data retrieved from the above step.
  4. The warehouse receives the return package and updates the return status in Flexport.
  5. The Flexport Webhook fires.
  6. The RMA is closed in Flexport.
  7. The return is automatically processed or flagged in Loop based on the receipt and merchant criteria.

Setup

Complete setup of the Loop and Flexport integration consists of:

  • Connecting both entities by way of API key.
  • Updating the return destination address in Loop.

Connecting Loop and Flexport

To connect Loop and Flexport:

  1. Log in to the Flexport portal.
  2. Go to Returns > Settings.

    This image shows the navigation menu on the left of Deliverr's site. Settings is nested under Returns and shows a screen with return destinations settings and return platforms to choose from.

  3. Beneath the Loop option, click +Connect. This will bring up a screen requesting an API key.

    This image shows the screen after clicking +Connect for the Loop integration option. In the center there is text saying

  4. In a separate tab or window, open the Loop admin and go to Tools & integrations > Developer tools.
  5. Scroll down to the "API keys" section, then copy an API key for the integration.

    This image shows the Loop admin Developer Tools page. The left-hand navigation shows Developer Tools nested under Tools and Integrations. The API keys section has a table with the current API keys' scopes, actual keys, names, and last used date and time. There is a Copy button next to each API key that merchants can click.

  6. Paste the API key on Flexport's page, then click Connect in the bottom right corner.

    This image shows the Connect Loop page on Deliverr with a fake API key input and the Connect Loop button in the bottom right corner.

  7. After confirming the successful integration, copy the address provided. Then, follow the instructions below to update the return destination in Loop.

    This image shows the confirmation page for the integration of Loop and Deliverr. The Copy Address button to the right of the Deliverr-provided address is highlighted for emphasis.


Updating the return destination address

To update the return destination address in Loop:

  1. In the Loop admin, go to Shipping > Destinations.

    This image shows the Loop admin navigation menu on the left, highlighting the Shipping tab and its nested Destinations page.

  2. Click Edit on the destination(s) the merchant needs to update.

    This image shows the Destinations page in the Loop admin, highlighting the Edit buttons to the right of the destinations shown.

  3. Scroll down to the "Address" section, then paste (or edit to match) the address received in Flexport upon integration confirmation.

    This image shows the Edit page for a specific destination in the Loop admin. The address section has several fields, the filled-out ones including Street Address, City, Postal or ZIP code, Country, State, and Phone Number.

  4. Click Save in the bottom right corner to ensure the changes stick.

    This image shows the Address section of the destinations editing page again, but with the Save button visible in the bottom right corner.


FAQ

What plan do I need to be on to utilize this feature? To check if this feature is included in your Loop plan, check the Pricing page on Loop's website. If you are not on one of the applicable plans and would like to add this feature, please contact your Merchant Success Manager or support@loopreturns.com.

Will I need a developer involved to complete this integration? No. The process of setting up the integration between Flexport and Loop is self-serve.

How do I get started? Using the steps above, you can connect your Loop and Flexport accounts yourself. If you have any questions or need assistance, please contact support@loopreturns.com.


Please contact support@loopreturns.com with any additional questions.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.