---
title: "New Warehouse Sub Account"
method: POST
path: "/v1/master/warehouse"
tags: ["Master API"]
---

# New Warehouse Sub Account

`POST /v1/master/warehouse`

## Request

- Base URL: `http://{{base_url}}`
- URL: `http://{{base_url}}/v1/master/warehouse`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/docs/v1/master/warehouse/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new Warehouse / 3PL account.

### Post Fields
|    Field    |    Data Type    |    Length    |    Required?    |    Description    |
|------------------|-----------------|--------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|
|    company    |    Array    |  |    Y    |    Company details    |
|    user       |    Array    |  |    N    |    Optionally create a new user for this warehouse.    |
|    wms    |    Array    |  |    N    |    Order Destination Info    |

### Company Array
|    Field    |    Data Type    |    Length    |    Required    |    Description    |
|-------------|-----------------|--------------|----------------|-------------------|
|    company    |    String    |    45    |    Y    |    Company Name    |
|    phone    |    String    |    45    |    N    |    Company Phone Number    |

### User Array
|    Field    |    Data Type    |    Length    |    Required    |    Description    |
|-------------|-----------------|--------------|----------------|-------------------|
|    name    |    String    |    45    |    Y    |    User Name    |
|    email    |    String    |    255    |    Y    |    User email    |
|    password    |    String    |    45    |    N   |   Account activation will be sent if you send the user object with no password.     |
|    repeat_password    |    String    |    45    |    N    |   Must match the password     |

### wms Array
|    Field    |    Data Type    |    Length    |    Required    |    Description    |
|-------------|-----------------|--------------|----------------|-------------------|
|    wms_name    |    String    |        |    Y    |    Which WMS should be setup?    |
|    wms_params    |    Array    |  |  N  |    Array of WMS level param values to set for this account. You can   get a list of valid values from the wms section of the [/wms/params](#99aefc50-34e7-4fa5-b944-9cbb24eaf594)   endpoint. NOTE: This section only usable by independant Merchant accounts, not ones that belong to a warehouse account.    |

### Array Response Fields
|    Field    |    Data Type    |    Length    |    Description    |
|----------------|-----------------|--------------|---------------------------------|
|    warehouse_pk    |    Int    |  |    Unique identifier for this warehouse account    |

## Headers

- `Content-Type` string

## Request body `*/*`

- string

## Response `200`

OK

- object

---

[API](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover.md) - [All operations](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/llms.txt) - [OpenAPI document](https://skmtc.dev/extensiv/apis/integration-manager-api-formerly-cartrover/revisions/125e6deac675?raw)