Skip to main content

Map Shiptheory Warehouse

PUT 

/api/shiptheory/:integration_instance/warehouses/:warehouse/mapping

Sets or updates a SKU warehouse's mapping on this instance (idempotent upsert). enabled=true also points the SKU warehouse's fulfillments at this Shiptheory instance, so dispatched fulfillment orders are submitted to Shiptheory; enabled=false clears the routing and returns the warehouse to manual fulfillment if this instance owned it. Shipments from a routed warehouse use the warehouse's own address as the sender; nothing address-related is set here.

Required scope: integrations:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Path parameter:

  • integration_instance: the numeric id of the Shiptheory integration instance.
  • warehouse: the SKU warehouse id.

Body fields:

  • enabled (boolean, required): whether this warehouse routes to Shiptheory.

Returns 200 with the upserted mapping. Returns 404 when the warehouse does not exist, or 422 with field errors when validation fails — including enabled=true on a warehouse that is not routable (supplier and other non-shipping warehouses).

Authentication: requires a Bearer token.

Request​

Responses​

OK

Response Headers
    Content-Type