Send the return shipping label and tracking

post

https://api.protectplus.io/returns/{return_id}/shipping-label

Notify Get Plus that your OMS has generated the return shipping
label. Get Plus stores the label and tracking details, moves the
return to IN_TRANSIT, and emails the customer the label and tracking
link.

Re-sending the same tracking_number for the same return is idempotent
and returns 200.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

return_id

string

required

The Get Plus return id — return_id from the POST /returns response, data.returns[].id from GET /returns, or data.return.id from GET /returns/{return_id}. NOT the top-level id from POST /returns (that is the return request, not the return).

Body Params

carrier

string

required

Carrier name, e.g. "USPS".

tracking_number

string

required

The return shipment's tracking number. Also the idempotency key for this callback.

label_url

string

required

URL of the printable shipping label your OMS generated.

tracking_url

string

Optional carrier tracking page URL shared with the customer.

external_reference

object

Optional reference to the return in your OMS. Stored on the Get Plus
return so both systems share one identity for the return — include it
on every callback so out-of-band and duplicate messages can be
correlated.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Label recorded and return marked in transit — or the same tracking number was already recorded (idempotent replay).

400Rejected by the returns service — missing required fields or the return is not on a custom-platform order.

401Unauthorized

403Return belongs to another store

404Unknown return_id — callbacks never create returns. The id must be an existing return (see GET /returns).

422Request body failed validation

429Rate limit exceeded