What is ShipMonk?
ShipMonk is a tech-enabled third-party logistics (3PL) provider offering comprehensive fulfillment services including warehousing, order fulfillment, inventory management, and shipping. With fulfillment centers strategically located across the United States, ShipMonk provides scalable e-commerce fulfillment solutions for growing brands. Primary Purpose: ShipMonk delivers end-to-end fulfillment services for e-commerce brands, combining warehousing, inventory management, order processing, and shipping with advanced technology for real-time visibility.What Does the Integration Do?
When a customer initiates a return through Redo, the system automatically creates an RMA (Return Merchandise Authorization) in ShipMonk, notifying the warehouse that items are being returned. Products are mapped using SKUs and linked to original orders for accurate tracking. Carrier, service, and tracking number are sent to the warehouse so staff can identify and match incoming returns. When ShipMonk finishes grading the received items, a webhook notification is sent to Redo to automatically process the return — issuing refunds, store credit, or creating exchange orders without manual intervention. Item disposition from ShipMonk (restockable vs. non-restockable) is used to determine how each item is processed.Item Discrepancy Handling
When ShipMonk reports a graded return, Redo compares the received quantities against what was expected and acts accordingly:- Quantity shortfall (fewer items received than expected): Only the items that were actually received are processed. A note is added to the return timeline — e.g., “SKU ABC123: expected 3 item(s) but only received 2” — so your team has a clear record of the discrepancy.
- Quantity overage (more items received than expected): Only the items matching the original return are processed. The same timeline note pattern applies.
- Non-restockable items: ShipMonk reports a final disposition per item (e.g., damaged, returned to inventory, reworked). Items marked as
returned_to_inventoryorreworkedare processed with restocking enabled; all others (damaged, fraud, lost, etc.) are processed without restocking. A timeline entry breaks down exactly how many items fell into each non-restockable disposition.
How to Set It Up
Follow these steps to configure the ShipMonk integration with Redo.Prerequisites
Before you begin, ensure you have:Active ShipMonk Account
Active ShipMonk Account
You must have an active account with ShipMonk as your 3PL provider with fulfillment services enabled.
ShipMonk API Key
ShipMonk API Key
You’ll need your ShipMonk API key for authentication. This can be found in your ShipMonk account under Account Settings > API.
ShipMonk Store ID
ShipMonk Store ID
You’ll need your ShipMonk Store ID. This can be found in your ShipMonk account settings alongside your API credentials.
Products and Orders Synced to ShipMonk
Products and Orders Synced to ShipMonk
Your products and orders must already be synced to ShipMonk, typically through your e-commerce platform (Shopify, BigCommerce, etc.). Returns cannot be created for products or orders that don’t exist in ShipMonk’s system.
Configuration Steps
Navigate to Integrations
Go to Settings > Returns & Claims > Integrations and locate the ShipMonk card.
Enter Connection Details
In the configuration form, provide:
- Store ID (required): Your ShipMonk store identifier
- API Key (required): Your ShipMonk API key for authentication
- Sandbox Mode (optional): Enable this to use ShipMonk’s sandbox environment for testing before going live
Test the Integration
Create a test return to verify the integration is working correctly:
- Initiate a test return through your Redo return portal
- Generate a return shipping label
- Check the return timeline in the Redo dashboard for a ShipMonk RMA creation entry
- Verify the RMA appears in ShipMonk with correct order linkage, products, quantities, and tracking information
Webhook Setup
Before setting up the webhook in ShipMonk, contact Redo support first to receive your unique webhook endpoint URL. Once you have that URL, follow ShipMonk’s webhook documentation to create a webhook subscription. In ShipMonk, navigate to Account Settings > Integrations, click New Integration, and select Webhooks. Configure the webhook for the Return Status Change event and point it to the endpoint URL provided by Redo.As a safety net, Redo also runs an hourly background sync that polls ShipMonk for any graded returns that may have been missed by webhooks. This means even if a webhook delivery fails, returns will still be picked up and processed automatically within the hour.
How Long Does It Take?
Setup Timeline
| Step | Time | Description |
|---|---|---|
| Obtain API Credentials | 2-5 minutes | Locate API Key and Store ID in ShipMonk account settings |
| Configure in Redo | 2-5 minutes | Enter credentials and save configuration |
| Configure Webhook | 5-10 minutes | Set up Return Status Change webhook in ShipMonk |
| First Return Test | 5-10 minutes | Create test return and verify RMA in ShipMonk |
| Total Setup | 15-30 minutes | Complete setup for most merchants |
Operational Timing
Return Processing
Automatic via webhook — when ShipMonk completes grading of received items, Redo automatically processes the return (refund, store credit, or exchange) based on the item dispositions reported by ShipMonk.
Warehouse Processing
Varies by warehouse SLA, typically 1-3 business days depending on your agreement with ShipMonk.