Skip to main content
POST
/
api
/
Resend
/
createResend
Create resend order
curl --request POST \
  --url https://api.returnshelper.com/uat/user/api/Resend/createResend \
  --header 'Content-Type: application/json' \
  --header 'x-rr-apikey: <api-key>' \
  --header 'x-rr-apitoken: <api-key>' \
  --data '
{
  "returnInventoryIdList": [
    123
  ],
  "resendShipment": {
    "shipmentCountryCode": "<string>",
    "shipmentName": "<string>",
    "shipmentPhone": "<string>",
    "shipmentStreet1": "<string>",
    "shipmentStreet2": "<string>",
    "shipmentState": "<string>",
    "shipmentCity": "<string>",
    "shipmentPostalCode": "<string>",
    "shipmentServiceType": "<string>",
    "shipmentFax": "<string>",
    "shipmentEmail": "<string>",
    "shipmentStreet3": "<string>"
  }
}
'
{
  "resendId": 123
}
Creates a resend order — bundles one or more received return inventory items into an outbound shipment to a customer address. Triggers asynchronous label generation; the label URL is delivered via webhook.

​
Prerequisites

  • The target inventory items exist in your account. The returnInventoryId values come from the newInventoryCreated webhook event — cache them on your side as parcels are logged.
  • All inventories in a single resend must be in the same warehouse.
  • Each inventory’s current handlingStatusCode must be eligible to advance to rsd (resend) per the handling state machine — typically items in ohd (on-hold) status.
  • None of the items’ line items can have pending VAS requests.
  • Each inventory must be physically in stock (not in-transit, not under another active workflow).
  • Have your destination address ready.

​
Required fields

  • resendShipment — full shipment payload (destination address, contact, dimensions, weight, service type). Country codes are ISO3.
  • returnInventoryIdList — non-empty List<long>. Maximum size is ResendConfig.groupResendMaxRmaCount (typically a single-digit cap; check via support if you need to bundle many items).

​
Side effects

  • Each inventory’s handlingCode is set to rsd and the matching status is applied.
  • The shipment is dispatched by the warehouse once the label is ready.

Authorizations

​
x-rr-apikey
string
header
required

Your API key

​
x-rr-apitoken
string
header
required

Your API token — keep this private

Body

application/json
​
returnInventoryIdList
integer<int64>[]
required

List of return inventory IDs for resend

​
resendShipment
object
required

Destination shipment address for the resend

Response

Success

​
resendId
integer<int64>

Created resend identifier