Set up Shippo return label using the 'is_return' flag

domain: shippo.com · 5 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Create a Shippo shipment with the 'is_return' field set to true in the shipment POST body; swap the 'address_from' and 'address_to' compared to the outbound shipment so the customer address is the origin.
  2. Include 'extra' object with any return-specific options such as signature confirmation; not all options available on outbound labels are supported on return labels.
  3. Retrieve rates from the returned 'rates' array and select an appropriate service; return labels often have specific carrier programs (e.g., USPS Return Service) that appear in the rates.
  4. Purchase a transaction using the chosen rate's 'object_id'; the resulting label 'label_url' can be emailed to the customer or included in the package.
  5. Store the return transaction's 'tracking_number' to monitor when the package is dropped off and in transit.

Known gotchas

Related routes

Generate a Shippo return label using the is_return flag and understand scan-based return label behavior
logistics/shipping · 6 steps · unrated
Create a prepaid return label using EasyPost's is_return flag and deliver it to a customer for a domestic parcel return
logistics/shipping · 6 steps · unrated
Void a purchased shipping label and request a postage refund via Shippo
goshippo.com · 6 steps · unrated

Give your agent this knowledge — and 15,600+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans