# Loop Returns integration

> Returns, exchanges, and warranty management API for Shopify brands using Loop.

- Authentication: apiKey

## Tools (88)

- **Add Cart Item**: Adds an item to the draft return's cart.
- **Add Product to Collection**: Attach a product to a collection.
- **Add Returning Item Exchange Item**: Adds an exchange item for a specific returning item to the cart. This endpoint is used when a customer is exchanging one item for another.
- **Add Returning Item User Input**: Adds user input for a specific returning item. This allows collecting additional information from the customer about their return.
- **Advanced Shipping Notice**: This endpoint will pull all packages by tracking statuses/timeframe. The ASN endpoint will return an array of objects. Those objects will contain order and return information. ### Required API key sco
- **Assess Dispositions**: Assess return line item dispositions. ### Required API key scope - Returns
- **Cancel Return**: Cancel a return in Loop. Canceling a return will allow a customer to make another return with the same items. ### Required API key scope - Returns
- **Close Return**: Close a return. Closing a return will not fulfill any outcomes such as exchanges or gift cards, and the items are not able to be used in a new return. Returns closed using this endpoint will also be c
- **Create Allowlist Item**: Create an allowlist entry. ### Required API key scope - Orders
- **Create Blocklist Item**: Create a blocklist entry. ### Required API key scope - Orders
- **Create Customer**: Create a new customer.
- **Create Destination**: Create a destination. ### Required API key scope - Destinations (Write)
- **Create Fraud Report**: Attach a fraud report to a return. ### Required API key scope - Returns
- **Create Location**: Create a new location.
- **Create Order**: Create a new order.
- **Create Payment Intent**: Creates a payment intent for the draft return.
- **Create Product**: Create a new product.
- **Create Product Variant**: Create a new product variant.
- **Create Return Deep Link**: Create a deep link URL. Depending on a shop's settings, the `zip` value could be an email, phone number, or postal code. All use the key `zip`. ### Required API key scope - Orders
- **Create Return Deep Link with QR Code**: Generate a link to a QR code image file that, when scanned, will take the user directly to their order in Loop so they can initiate a return without requiring them to enter their order information. Th
- **Create Return Note**: Post a new note to a return. ### Required API key scope - Returns
- **Create Webhook**: Create a new webhook subscription.
- **Delete Blocklist Item**: Delete a blocklist entry. ### Required API key scope - Orders
- **Delete Collection**: Delete a collection.
- **Delete Customer**: Delete a customer.
- **Delete Destination**: Delete a destination. ### Required API key scope - Destinations (Write)
- **Delete Fraud Report**: Delete the fraud report attached to a return. ### Required API key scope - Returns
- **Delete Location**: Delete a location.
- **Delete Order**: Delete a specific order.
- **Delete Product**: Delete a product.
- **Delete Product from Collection**: Delete a product from a collection.
- **Delete Product Variant**: Delete a product variant.
- **Delete Webhook**: Delete a webhook subscription.
- **Detailed Returns List**: Pull a detailed list of returns created within a given timeframe. This endpoint supports pagination. We _highly_ encourage using [pagination](https://docs.loopreturns.com/reference/paginated-requests)
- **Finalize Items**: Finalizes the returning items and cart items of the draft return.
- **Flag Return**: Flag a return in Loop for review. This will prevent automated processing and will require a human to go into the merchant admin in Loop and review this return. ### Required API key scope - Returns
- **Get All Destinations**: Retrieve all destinations. ### Required API key scope - Destinations (Read)
- **Get Blocklist Item**: Retrieve a blocklist entry. ### Required API key scope - Orders
- **Get Collection**: Get details about a single collection.
- **Get Customer**: Get details about a single customer.
- **Get Destination Details**: Get details for a single destination. ### Required API key scope - Destinations (Read)
- **Get Draft Return**: Retrieves the details of a draft return, including its current state, returning items, cart items, and available actions. The response includes the draft return data, context information, and any avai
- **Get Location**: Get the details about a single location.
- **Get Order**: Get details about a specific order.
- **Get Product**: Get the details about a single product.
- **Get Product Variant**: Get the details about a single product variant.
- **Get Return Details**: Get the details of a specific return based on a return's ID, an order name, or an order ID from the commerce provider (e.g. Shopify) depending on the query value of the call. ### Required API key scop
- **Get Return Notes**: Get notes on a specific return using the return's ID. ### Required API key scope - Returns
- **Get Sample Webhook**: Retrieve a sample webhook payload for a given topic and trigger, populated with the shop's data.
- **Get Shipment Information**: Get high level information from a Happy Returns shipment. ### Required API key scope - Happy Returns Shipments (Read)
- **Get Shipment Items**: Get all items for a Happy Returns shipment. ### Required API key scope - Happy Returns Shipments (Read)
- **Get Shipments**: Get information about all Happy Returns shipments created within a given timeframe. The response is a paginated list of shipments, with up to 200 shipments per page. If no date range is provided, the
- **Get Webhooks**: Get all webhook subscriptions. This includes webhooks created programmatically and webhooks created in the Loop Admin.
- **Grade Items**: Grade the condition of return line items. ### Required API key scope - Returns
- **List Allowlist Items**: Retrieve a list of paginated allowlist entries. ### Required API key scope - Orders
- **List Blocklist Items**: Retrieve a list of paginated blocklist entries. ### Required API key scope - Orders
- **List Collections**: Retrieve a list of collections. The list can be filtered, sorted, and paginated using the parameters below.
- **List Customers**: Retrieve a list of customers. The list can be filtered, sorted, and paginated using the parameters below.
- **List Locations**: Retrieve a list of locations. The list can be filtered, sorted, and paginated using the parameters below.
- **List Orders**: List all orders.
- **List Products**: Retrieve a list of products. The list can be filtered, sorted, and paginated using the body parameters below.
- **List Product Variants**: Retrieve a list of product variants. The list can be filtered, sorted, and paginated using the body parameters below.
- **Process Return**: Process a return in Loop based on the return ID. Processing a return will archive it in Loop and fulfill any remaining outcomes, such as placing exchange orders or creating gift cards. **Processing No
- **Remove Cart Item**: Removes a specific item from the draft return's cart.
- **Remove Line Items**: Remove line items from a return and process the return. Currently, only line items tied to a refund or store credit outcome allow for line items to be removed programmatically. ### Required API key sc
- **Remove Payment Intent**: Removes a payment intent from the draft return.
- **Remove Returning Item**: Removes a specific item from the draft return's ReturningItems.
- **Replace Product Variant**: Replace a product variant. Accepts the same body as `PATCH`.
- **Select Return Method**: Selects a return method for the draft return.
- **Select Return Method Carrier**: Selects the carrier label format for a previously selected return method.
- **Set Credit Type**: Sets the credit type for the draft return.
- **Set Returning Item Return Reason**: Sets the return reason for a specific returning item.
- **Set Returning Item Return Type**: Sets the return type (credit or exchange) for a specific returning item.
- **Submit Draft Return**: Submits the draft return. This finalizes the return and initiates any necessary workflows. Once the return has been submitted, it can be processed.
- **Unfinalize Items**: Reopens the returning items and cart items of the draft return for modification.
- **Update Collection**: Update a collection.
- **Update Customer**: Update a customer.
- **Update Destination**: Update a destination. ### Required API key scope - Destinations (Write)
- **Update Location**: Update a location.
- **Update Order**: Update a specific order. Accepts the same body as `PUT`.
- **Update Product**: Update a product. Accepts the same body as `PUT`.
- **Update Product Variant**: Update a product variant.
- **Update Webhook**: Update a webhook subscription.
- **Upsert Customer**: Upsert a customer, identified using the customer's `external_id`.
- **Upsert Location**: Upsert a location, identified using the location's `external_id`.
- **Upsert Order**: Upsert an order using the external_id.
- **Upsert Product**: Upsert a product, identified using the product's `external_id`.
- **Upsert Product Variant**: Upsert a product variant, identified using the product's `external_id`.

Connect Loop Returns in General Input: https://www.generalinput.com/apps/loop-returns