Skip to main content

​
Overview

If you’re building a custom integration between your third-party logistics (3PL) provider, warehouse management system (WMS), or other external system and Redo, this guide will help you understand how to leverage our APIs to create seamless return workflows.

​
Choosing the Right API

Before building your integration, determine which Redo API best fits your needs:

Loop-Compatible API

Use this if: You already have a Loop Returns integration builtMinimal redevelopment work required - simply change the base URL from Loop to Redo and your integration continues working. Covers Loop’s warehouse return endpoints (return details, list, flag, remove line items, close, cancel, notes, process, and ASN reporting).

Redo Native API

Use this if: You’re building a new integration from scratchFull access to all Redo features with comprehensive endpoint documentation.

​
What You Can Build

Redo’s APIs enable you to create powerful integrations that automate your return workflows. Here are the core capabilities:

​
Returns Management

Create, retrieve, update, and manage returns throughout their lifecycle. You can:
  • Fetch return details including items, customer information, and status
  • Update return statuses as they progress through your warehouse
  • Add comments and notes to returns for internal tracking
  • Process returns to trigger refunds or exchanges
Key Endpoints:
  • GET /stores/{storeId}/returns - List all returns for a store
  • GET /returns/{returnId} - Fetch a single return
  • PUT /returns/{returnId}/status - Update return status
  • POST /returns/{returnId}/process - Process a return to trigger refunds or exchanges

​
Return Shipping

Redo generates return shipping labels when a return is created. Your integration reads the resulting shipment data from the return — there are no separate endpoints for rating or purchasing labels:
  • Download shipping label documents via the postageLabel and formLabel URLs on each shipment
  • Read carrier, tracking number, and tracking URL for each return shipment
  • Monitor shipment status (pre_transit, in_transit, delivered, etc.) and estimated delivery date
This data is available in the shipments field of the return object, returned by the endpoints above and included in return webhook payloads.

​
Invoicing

Access invoice data for returns processing:
  • Retrieve invoices with their charge amount and status
  • Export invoice line items as CSV for accounting systems
Key Endpoints:
  • GET /stores/{storeId}/invoices - List invoices
  • GET /invoices/{invoiceId}/items.csv - Export line items for an invoice
  • GET /invoices/pending/items.csv - Export line items for the pending invoice

​
Webhooks

Set up real-time notifications for return events. Webhooks use a single return topic that delivers created and updated events containing the full return and order objects:
  • Receive a created event when a return is initiated
  • Receive an updated event whenever a return changes — status transitions, shipment tracking updates, refund processing, and item changes all arrive as updated events
  • Compare the payload against your stored state to determine what changed
Key Endpoints:
  • POST /stores/{storeId}/webhooks - Create webhook subscriptions
  • GET /stores/{storeId}/webhooks - List webhook subscriptions

Webhooks Guide

Learn more about setting up webhooks for real-time event notifications

​
Typical Integration Flow

Most 3PL/WMS integrations follow this pattern:

​
Implementation Steps

1

Set Up Authentication

Get your API credentials from support@getredo.com and implement authentication in your integration

Authentication Guide

Learn how to authenticate API requests
2

Subscribe to Webhooks

Configure webhooks to receive real-time notifications when returns are created or updated
3

Handle Return Creation

When a webhook notifies you of a new return, fetch the return details and create an RMA in your 3PL/WMS system
4

Update Return Status

As returns progress through your warehouse (received, inspected, restocked), update the return status in Redo
5

Trigger Processing

Once inspection is complete, use the process endpoint to trigger refunds or exchanges

​
Testing Your Integration

Before going live, thoroughly test your integration:
  1. Test in a sandbox environment - Ask support about sandbox/test store access
  2. Create test returns - Verify your system correctly receives and processes webhooks
  3. Test status updates - Ensure status changes flow properly between systems
  4. Verify error handling - Test how your integration handles API errors and timeouts
  5. Load testing - Confirm your integration can handle your expected return volume

​
Rate Limits and Best Practices

API rate limits apply to all endpoints. Contact support for specific rate limit details for your account.
Best Practices:
  • Implement exponential backoff for retries on failed requests
  • Cache frequently accessed data to reduce API calls
  • Use webhooks instead of polling for real-time updates
  • Batch operations when possible to minimize API requests
  • Log all API interactions for debugging and audit purposes

​
Next Steps

API Reference

Explore all available endpoints with detailed documentation

Webhooks Guide

Set up real-time notifications for return events

Authentication

Learn how to authenticate your API requests

Error Handling

Understand API errors and how to handle them

​
Need Help?

Building a custom integration? Our team is here to help:
  • Email: support@getredo.com
  • Technical Questions: Reach out for guidance on API implementation
  • API Credentials: Contact us to receive your API keys and sandbox access
We can also discuss your specific integration requirements and provide architectural guidance for complex workflows.