Create Product Warehouse Location

POST 
/api/v2/product-warehouse-locations

Assign a preferred storage bin to a product in a warehouse. The location must be an active put-away destination. The first assignment for a product+warehouse automatically becomes the default; new assignments append to the end of the ordered list unless priority is given.

Body fields:

• product_id (required) — product to assign.
• warehouse_id (required) — warehouse the bin lives in.
• warehouse_location_id (required) — the bin; must belong to the warehouse and be a put-away destination.
• is_default (optional, boolean) — mark as the product+warehouse default.
• priority (optional, integer ≥ 0) — explicit position in the ordered list; omitted assignments append to the end.

Authentication: Requires Bearer token. Scope: warehouses (read/write). Requires the warehouses.manage_locations permission.

Request

Responses

201

Created

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

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.

422

Unprocessable Content

429

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.