---
title: "Return Actions Overview"
slug: "loop-returns-for-sidekick"
updated: 2026-01-20T14:36:34Z
published: 2025-01-30T20:02:48Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gladly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Return Actions Overview

This Documentation is for a Gladly AI Integration

This documentation is for an integration used by Gladly AI. Apps like this will soon also be able to display data and provide actions that interact with external systems and products within Agent-facing Customer Profiles. However, if you are looking for this capability now, you may be more interested in [our list of integrations for Gladly Team](https://help.gladly.com/docs/list-of-app-integration-partners).

## Benefits

**Increased Agent Productivity**

Frees up agents to focus on more complex, high-impact tasks rather than handling routine return or exchange requests.

**Faster Customer Resolutions**

Provides customers with a direct link to complete their return or exchange, ensuring quick and seamless service without delays.

**Enhanced Customer Experience**

Empowers customers to take action independently, reducing wait times and improving satisfaction.

**Operational Efficiency**

Reduces the volume of repetitive inquiries handled by Agents, optimizing workflow and team bandwidth.

## Available Actions

- **Pull Existing Returns**
  - **Detailed Return Data**

    - id
    - state (closed or open)
    - createdAt
    - updatedAt
    - editedAt
    - currency
    - url
    - outcome
    - customer email
    - order: Loop id, name, provider id, number
    - return:
      - product total
      - discount total
      - total
      - items:
        - id
        - provider id
        - product id
        - variant id
        - sku
        - title
        - return reason
        - parent return reason
        - returnedAt
        - outcome
        - comment
        - cost: price, discount, tax, total
    - exchange:
      - product total
      - discount total
      - tax total
      - total
      - out of stock status
      - out of stock resolution
      - items:
        - id
        - order id
        - product id
        - variant id
        - sku
        - title
        - cost: price, discount, tax, total
    - cost breakdown: handling fee, gift card amount, refund, upsell
    - shipping:
      - carrier
      - tracking number
      - label status
      - status page URL
      - destination id
      - return method
      - label updatedAt
- **Create Return Link**
  - Creates a clickable Return link directly to the Loop Returns portal, for personalized and streamlined returns and exchanges. Includes Customer and Order information.

## Example Use Cases

- A Customer contacts support asking for the status of their Return. Sidekick pulls their most recent Return, and provides current data on when the Return was processed, and tells the Customer that they have been credited.
- A Customer wishes to initiate a Return. Sidekick asks onboarding details to identify the Customer, clarifies the Order the Customer wishes to return, and provides a personalized link to the Loop Returns portal for the Customer’s Order.

Contact Gladly Support to add this App to your Gladly instance! Please note that you need a developer resource to complete this installation.

Users assigned the **Team Manager** or **Administrator** roles can contact [Gladly Support](https://help.gladly.com/product-docs/pages/en/contact-gladly-support-team). Log into Gladly as one of these roles, click![hamburger-menu-icon(1)](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/hamburger-menu-icon(1).svg)on the top-left corner, then click **Contact Gladly Support**. Gladly Support's primary operating hours are Monday through Friday, 6 AM to 6 PM Pacific Time, but you can submit a request anytime.

- Please select the correct business impact (P1 to P4).
- Most requests should be sent as a P4.