Overview

Amazon has refreshed its Selling Partner API (SP‑API) Listings Items endpoint to let approved sellers create and manage product listings on Amazon Haul through code. The change, rolled out in early 2024, enables bulk uploads, price tweaks, and inventory updates for items priced under $20, eliminating the previous manual entry method. Sellers targeting the budget‑focused Haul storefront should act now to integrate the new parameters and stay competitive.

Key Points

• API version v2021‑08‑01 now includes Haul fields — Sellers can submit Haul‑specific attributes without changing the API version they already use.
• Bulk creation of sub‑$20 listings — A single request can add dozens of low‑price items, streamlining the onboarding of impulse‑buy catalogs.
• Full edit capability — Pricing, stock quantity, and product description can be altered programmatically, supporting rapid repricing strategies.
• Multi‑offer and multi‑fulfillment support — Sellers may attach several offers (e.g., standard and Prime) to the same Haul SKU, each with its own fulfillment method.
• US‑only rollout — The new functionality is limited to Amazon.com; other marketplaces will not accept Haul parameters until a future update.
• Backward compatible — Existing integrations that do not use Haul fields continue to work unchanged, avoiding disruption for current users.

How Listings Items API Handles Haul Listings

1. Enable Haul parameters in the request payload — Add the haul object to the JSON body of a POST /listings/2021-08-01/items call.
   • Example: "haul": { "price": { "amount": "9.99", "currency": "USD" }, "category": "Fashion", "priceCeiling": 20 }
2. Submit a bulk request — Include an array of up to 100 Haul SKUs in a single API call to create multiple listings at once.
   • Example: The payload contains ten different phone accessories, each with its own and block, allowing a single HTTP request to register the entire set.