Generate prepaid return shipping label (AUDIT-022-G3 canonical)
Generates a prepaid return shipping label for the customer using the entity’s configured
Shippo carrier account. The label URL is returned in the response and also emailed to the
primary contact if send_email: true is specified. Label cost is posted as a Return-Shipping
Expense GL journal entry.
Requires returns:write scope.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_
Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Headers
Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.
255Path Parameters
Response
Return label generated

