Create WFS Removal
POST/api/walmart/:integrationInstance/wfs/removals
Prepare a removal (status draft) from the integration's WFS inventory — several SKUs with units each, and the method: return_to_seller (needs seller_warehouse_id, one of your own warehouses) or disposal. Every SKU must be at WFS with at least the requested units available (summed across ship nodes); a violation is a 422 naming the SKU and its available units. Assigns the removal's reference (RMV-<instance>-<n>). Submit the same items and units in Seller Center, then record its removal order id with Mark WFS Removal Submitted. Requires a Bearer token.
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Request
Responses
- 201
- 401
- 403
- 404
- 422
- 429
Created
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
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.