Pull from Loop Returns

How to authenticate

Loop Returns uses API Key authentication for secure access.

1. Generate your API key in Loop Returns:
   
   • Log into your Loop Returns admin dashboard at https://admin.loopreturns.com
   • Navigate to Returns Management > Tools & integrations > Developer Tools
   • In the API keys section, click Generate API key
   • Give your key a descriptive name (e.g., "Parabola Integration")
   • Select the required scope: Returns (this is required to access return data)
   • Copy your API key and store it securely
2. Connect in Parabola:
   
   • In your Parabola flow, add a Pull from Loop Returns step
   • Click Authorize and paste your API key when prompted

Available data

Using the Loop Returns integration in Parabola, you can pull comprehensive return and shipping data:

• Detailed Returns List: Full return records including order information, customer details, line items with product and pricing data, exchange information, refund amounts, gift card details, label tracking, return methods, addresses, timestamps, and return states. Filter by date ranges (created or updated) and return status (open, closed, cancelled, expired, or review).
• Return Details: In-depth information on a specific return by return ID, order ID, or order name. Includes complete line item details with conditions and dispositions, exchange orders, labels with carrier and tracking data, refund processing information, Shopify refund objects, and all timestamps.
• Advanced Shipping Notice (ASN): Package-level tracking data including return line items, carrier details, tracking numbers and statuses, label rates and URLs, shipping destinations, product information (SKU, barcode, title), pricing and currency, order and return references, delivery dates, return reasons and outcomes, restock status, and consolidation tracking for multi-item shipments.

Common use cases

• Reconcile returns data across Shopify, Loop, and your warehouse to ensure return statuses, refunds, and inventory adjustments are aligned across all systems.
• Monitor return rates and reasons by product or SKU to identify quality issues, sizing problems, or products with high return rates that need attention.
• Track return processing performance and carrier SLAs by analyzing time from return creation to delivery, identifying bottlenecks, and monitoring which carriers perform best.
• Generate daily or weekly returns dashboards consolidating return volumes, exchange vs. refund rates, revenue retained, and operational KPIs for finance and operations teams.
• Audit return shipping costs against carrier invoices by comparing Loop's label rates with actual carrier charges to catch billing discrepancies and overcharges.

Tips for using Parabola with Loop Returns

• Schedule your flow to run daily or hourly to keep return data current and enable real-time monitoring of return operations.
• Use date filters strategically. The Detailed Returns List defaults to the last 24 hours if no dates are provided. For historical analysis, specify both from and to dates (maximum 120-day range).
• Filter by return state to focus on specific stages including "open" for active returns, "closed" for completed returns, or "review" for returns flagged for manual inspection.
• Combine with Shopify and 3PL data to create unified return-to-fulfillment reports that track the complete lifecycle from customer return initiation through warehouse processing.
• Add alerts via email or Slack to notify operations teams when return volumes spike, high-value returns are initiated, or returns remain in "open" state beyond acceptable thresholds.
• Export summaries to Google Sheets or your BI tool for team visibility and to power executive dashboards showing return trends and operational performance.