Update 3PL Order Label Settings
PUT/api/walmart/:integrationInstance/sww-label-settings
Update the settings for buying Ship With Walmart labels for seller-fulfilled Walmart orders that a 3PL warehouse ships. Only the fields sent are changed; other Walmart integration settings are kept. Turning the setting on without choosing a shipping method creates (or reuses) a "Walmart Label Provided" shipping method and uses it. Returns the saved settings.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Requires the integrations.update permission.
Request body:
purchase_for_3pl_orders(boolean, required): turn automatic label buying on or off.service_preference(string, optional):cheapestormatch_requested. Unchanged when omitted.label_provided_shipping_method_id(integer|null, optional): an existing shipping method ID to switch label-provided fulfillment orders to. Send null to use the default "Walmart Label Provided" method. Unchanged when omitted.fallback_box(object|null, optional): default box for multi-unit orders with no known box size. Send null to clear it. When sent, all four fields are required:fallback_box.length(number, > 0)fallback_box.width(number, > 0)fallback_box.height(number, > 0)fallback_box.unit(string):inorcm
The response has the same shape as Get 3PL Order Label Settings.
Path parameters:
- integrationInstance (required): Walmart integration instance ID.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.