Validate the return eligibility against the order's return window, item condition policy, and carrier return program rules before creating the RMA
POST a Return resource via the Shopify REST or GraphQL Admin API referencing the original order ID and line items being returned with their quantities and reason codes
Capture the RMA number from the API response and communicate it to the customer via email with return instructions and the authorized item list
Notify the warehouse management system of the pending return with the RMA number, expected item list, and preferred disposition (restock, quarantine, destroy)
Set a return expiry date on the RMA and implement a job to close expired RMAs that were never received
Known gotchas
An RMA does not automatically generate a return shipping label; label creation is a separate API call or carrier integration step
Disposition must be specified before the warehouse receives the goods; an RMA without a disposition instruction causes receiving backlogs
Return reason codes should align with your refund policy rules; mismatched reason codes can trigger incorrect refund amounts or auto-approval of ineligible returns
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp