Loop

Generates a direct link to a Loop Returns order page for customers to initiate returns or exchanges.

This integration creates a secure, customer-specific deep link to an order within the Loop Returns platform. When customers need to return or exchange items, this tool generates a direct URL that takes them straight to their order details in Loop Returns, bypassing the need to manually search for their order. This streamlines the returns process and improves customer experience.

Parameters

• order_name (String): The unique identifier or name of the order to link to. This can be in formats like “#1234567” or “1234567”. Example: “#1245678”.
• customer_email (String (email)): The email address of the customer who placed the order. This is used for verification and security purposes. Example: “sarah.johnson@example.com”.

Output

Returns a JSON object containing a single url field with the generated deep link. This URL directs the customer to their specific order page within the Loop Returns portal where they can initiate returns, exchanges, or view return status.

Example Output:

{
  "url": "https://mystore.loopreturns.com/#/link/a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Retrieves detailed return information from Loop Returns using order or return identifiers.

This integration connects to Loop Returns to fetch comprehensive details about a specific return request. You can look up return information using either an order ID, return ID, or order name. This helps support teams quickly access return status, refund amounts, shipping labels, customer details, and individual line item information for processing returns and answering customer inquiries.

Parameters

• return_id (Integer): The unique identifier for a specific return request. Example: 123456.
• order_id (Integer): The unique identifier for the original order. Example: 987654.
• order_name (String): The order name/number from your e-commerce platform. Example: “FP-123141”.

Note: At least one parameter is required to perform the lookup.

Output

Returns a comprehensive return object containing id, state, total, refund, customer, order_name, shipping labels with tracking numbers, and detailed line_items array with product information, SKUs, prices, return reasons, and outcomes. When no return is found, returns an error message stating “No returns originated from an order with this name.”

Example Output:

[{
  "id": 101785420,
  "type": "standard",
  "state": "open",
  "total": "56.60",
  "refund": "56.60",
  "currency": "USD",
  "customer": "sarah.mitchell@example.com",
  "customer_email": "sarah.mitchell@example.com",
  "customer_first_name": "sarah",
  "customer_last_name": "mitchell",
  "order_name": "#942391",
  "order_number": 941391,
  "tracking_number": "9434636106023325941797",
  "label_status": "delivered",
  "created_at": "2026-02-19 12:46:58",
  "updated_at": "2026-03-05 18:34:58",
  "line_items": [{
    "sku": "FCE-SPF-40U",
    "title": "OS-01 FACE SPF BROAD SPECTRUM SPF 30+ PA+++",
    "variant_title": "Untinted",
    "price": "47.60",
    "refund": "56.60",
    "reason": "I only meant to order one of this product",
    "parent_reason": "I ordered this by mistake",
    "outcome": "default",
    "returned_at": "2026-02-19 12:46:58"
  }],
  "labels": [{
    "url": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20260219/e8179ace12abf34afcaad25add1069810b.pdf",
    "carrier": "USPS",
    "tracking_number": "9434636106023325941797",
    "status": "delivered"
  }]
}]