Create a return label
Creates a new return shipping label for customer returns to your warehouse.
Parameters
Request Body
original_label_id
string
ID of the original outbound label (for tracking)
from_address
object
Required
Customer's address (where return ships FROM)
to_address
object
Required
Warehouse/returns center (where return ships TO)
parcel
object
Required
carrier
string (USPS | FEDEX | UPS | DHL | CANADA_POST)
Preferred carrier (optional)
service
string
Preferred service level
reference
string
Your internal reference number
reason
string (defective | not_as_described | wrong_item | unwanted | damaged | other)
Reason for return
rma_number
string
Custom RMA number (auto-generated if not provided)
notes
string
Additional notes for the return
Returns
201
Return label created successfully
400
Validation error
401
Authentication required
404
Original label not found (if original_label_id provided)
Related
Returns
POST/api/v1/returns