Help CenterGitHub

Generate Return Label

Generate and purchase a return shipping label

Generates and purchases a return shipping label for the specified return. The label cost will be deducted from your organization's wallet balance.

Important: Ensure sufficient wallet balance before calling this endpoint.

Parameters

Path Parameters

id string required
The return ID

Request Body

carrier string
Preferred carrier (USPS, UPS, FEDEX). If not specified, uses cheapest option.
service string
Preferred service level

Returns

200 Return label generated successfully
400 Label already generated or invalid request
402 Insufficient wallet balance

Related

returns
label
purchase
POST/api/returns/{id}/label
atoship © 2026