createSandboxLocation

post

https://sellingpartnerapi-na.amazon.com/externalFulfillment/2026-07-30/location

Creates a sandbox location and merchant in the test environment. This operation is available only in the sandbox environment and is used for onboarding test locations. Idempotency is ensured on locationName.

Body Params

The request body for creating a sandbox location.

The request object for creating a sandbox location.

merchantIds

array of strings

required

length ≥ 1

The list of merchant identifiers to create the location for. This list will have more than one entry only in case of MSF (Multi-Seller Fulfillment) location creation. In other cases, only one merchant should be passed in.

merchantIds*

marketplaceId

string

required

The identifier for the marketplace. Refer to Marketplace IDs for the full list of supported marketplace IDs.

channels

array of strings

length ≥ 1

The list of channels to enable for the location. Defaults to ["FBA", "MFN"] if not specified.

channels

Allowed:

locationName

string

required

length between 1 and 60

The name for the sandbox location. Idempotency is ensured on this field.

Responses

Language

Loading…

Response

Choose an example:

application/json

201Successfully created a sandbox location.

400Request has missing or invalid parameters and cannot be parsed.

403Indicates that access to the resource is forbidden. Possible reasons include Access Denied, Unauthorized, Expired Token, or Invalid Signature.

404The resource specified does not exist.

413The request size exceeded the maximum accepted size.

415The request payload is in an unsupported format.

429The frequency of requests was greater than allowed.

500An unexpected condition occurred that prevented the server from fulfilling the request.

503Temporary overloading or maintenance of the server.