Publish Location-Level Inventory

Learn how to publish location-level inventory.

Prerequisites

To complete this tutorial, you need:

• Authorization from the selling partner for whom you are making calls. For more information, refer to Authorizing Selling Partner API applications.
• Location ID and SKU ID details from the seller.
• Approval for the Inventory and Order Tracking role in your developer profile.
• The Inventory and Order Tracking role selected in the App registration page for your application.

🚧

Important

The merchant must be allowlisted on the External Fulfillment API to be able to update inventory using the External Fulfillment Inventory API. For allowlisting and onboarding, coordinate with your Amazon Business team.

Publish location-level inventory

Call the batchInventory operation. Supply the locationId:

• DEFAULT for the MFN single location
• Channel location ID for MFN multi-location
• Four-character warehouse code for Seller Flex / FBA Onsite

Also supply the skuId in the uri value, and use POST as the method value. You can submit up to ten requests in a single batch.

⭐

Tip

Only update SKUs that have changed rather than syncing your entire catalog. If the SKU ID contains special characters or whitespace, you must URL encode the SKU ID value.

Request example

POST "https://sellingpartnerapi-na.amazon.com/externalFulfillment/inventory/2024-09-11/inventories"
{
  "requests": [
    {
      "method": "POST",
      "uri": "/inventory/update?locationId=DEFAULT&skuId=efptestsku1",
      "body": {
        "quantity": 25,
        "clientSequenceNumber": 12345678,
        "marketplaceAttributes": {
          "marketplaceId": "AXJDDKDFDKDF",
          "channelName": "MFN"
        }
      }
    }
  ]
}