capabilities.work

Validate and Create a Return

A 3-step recipe with Sendcloud. We can help you get access.

Recipe · 3 steps

Validate and Create a Return

with Sendcloud
Works with AI assistants

Validate a return, create it, and retrieve its detail.

  1. Send the return payload to the validation endpoint to confirm it passes all checks before any return is actually created.
  2. Create the standalone return now that the payload has been validated, returning the new return id and incoming parcel id.
  3. Retrieve the created return by its id to expose its current status and tracking detail.
What you'll need to have ready
  • fromAddress: Return sender address (name, address_line_1, postal_code, city, country_code).
  • toAddress: Return destination address (name, address_line_1, postal_code, city, country_code).
  • shippingOptionCode: Shipping option code for the return (e.g. dpd:return/return).
  • weight: Weight object for the return parcel (value and unit).
  • orderNumber: Identifier of the order associated with this return.
  • parcelItems: List of items contained in the return (required for non-EU returns).
For your developer

Arazzo workflow sendcloud:validate-create-return, 3 operations: sc-public-v3-scp-post-returns_validate → sc-public-v3-scp-post-returns_create_new_return → sc-public-v3-scp-get-returns_get_details. Specs on APIs.io.

More recipes with Sendcloud

Announce a Shipment and Get its Return Portal URLAnnounce a Shipment with LabelBulk Print Labels for Recent ParcelsCancel a Shipment with ConfirmationCreate a Parcel and Fetch its LabelCreate a Parcel and Get its Return Portal URLCreate a Parcel and Track its ShipmentCreate a Return and Cancel It If CancellableRegister an External Parcel and Track ItShip an Order Asynchronously and Poll the Parcel