# Loop Returns

This Integration requires Fides Cloud or Fides Enterprise. For more information, [talk to our solutions team.](/content/speak-with-us?utm_source=docs-site/index.html)

[Loop Returns](https://loopreturns.com/) is a returns management platform that helps e-commerce businesses streamline their return processes, reduce costs, and improve customer experience through automated return workflows and analytics.

## Prerequisites

To integrate with Loop Returns, we use OAuth 2.0 authorization code flow. This ensures secure access to your Loop Returns data while maintaining proper authentication standards.

To configure OAuth 2.0 authentication with Loop Returns, you'll need to set up an OAuth application in your Loop Returns account. Follow the Loop Returns documentation to request an [oauth application](https://docs.loopreturns.com/api-reference/authentication)

Once you have this configured, you'll need to collect the following information:

| Name | Description |
| :-- | :-- |
| **Client ID\*** | Your OAuth client ID from the Loop Returns application settings |
| **Client Secret\*** | Your OAuth client secret from the Loop Returns application settings |
| **Redirect URI\*** | The Fides URL to which users will be redirected upon successful authentication (ex. `https://{your fides url}/api/v1/oauth/callback`) |
| **Order Name\*** | The dataset reference to the Shopify Order Name associated with a return which maps to the desired user (Order name may be in the format "#1234" or "1234") |

Your Loop Returns OAuth application will need access to the following scopes: `offline_access`, `labels:read` and `returns`

You will also need to add the Fides redirect URI to the list of accepted redirect URIs in your Loop Returns OAuth application settings.

The `installation url` on the oauth setup can be any url. The integration doesn't use this parameter.

## Integrating with Loop Returns

To integrate an existing system with Loop Returns:

1. Navigate to **Data map** → **View Systems** and choose the system that you want to connect.
2. Click on the **Integrations** tab.
3. Pick the vendor or system type that you want to integrate with from the **Connection type** drop-down menu.
4. Complete the required fields for the integration and click **Save**.

To authorize the integration so that it can connect to Loop Returns:

1. Click on **Authorize integration** to be redirected to the Loop Returns authorization screen
2. Enter your Loop Returns credentials and click **Log in**. You will automatically be redirected back to the Fides UI using the `Redirect URI` that was provided in the form in the previous step.

You may now confirm your connection is working using the **Test connection** button, if desired.

To learn more, please see our guide for [Managing Integrations](/content/docs/integrations/guides/manage-integrations/index.html).

## Technical detail

Fides utilizes _API endpoints_ to access the _API service_ for a SaaS application. An _API service_ is the programmatic interface through which Fides can query and update data within an application to access, rectify, or delete personal information. Each SaaS tool will have a unique set of endpoints to enable privacy functions.

### Loop Returns Endpoints

In the table below, you can find which endpoints are used for each type of privacy function. Clicking on the endpoint will take you to the documentation for that endpoint.

| Privacy function | Endpoint | Description |
| --- | --- | --- |
| **Access Requests** | [Returns](https://docs.loopreturns.com/api-reference/latest/return-data/get-return-details) | Used to search and fetch return information by order name. |
| **Access Requests** | [Labels](https://docs.loopreturns.com/api-reference/latest/label-requests/get-label-request) | Used to fetch label request information for returns.