---
title: "New Merchant"
method: POST
path: "/v1/wms/merchant"
tags: ["Warehouse API"]
---

# New Merchant

`POST /v1/wms/merchant`

## Request

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

Creates a new merchant user and returns API credentials for that merchant.

### Post Fields
|    Field    |    Data Type    |    Length    |    Required?    |    Description    |
|------------------|-----------------|--------------|-----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|
|    name    |    String    |    80    |    Y    |    Name of Merchant    |
|    user    |    Array    |  |    N    |    Optionally create a new user for this merchant. User will receive a password setup email.    |
|    wms_params    |    Array    |  |  |    Array of WMS param values to set for this merchant. You can get a list of valid values from the merchant section of the /wms/params endpoint.    |

### User Array
|    Field    |    Data Type    |    Length    |    Required    |    Description    |
|-------------|-----------------|--------------|----------------|-------------------|
|    email    |    String    |    255    |    Y    |    User email    |
|    name    |    String    |    45    |    Y    |    User Name    |

### Array Response Fields
|    Field    |    Data Type    |    Length    |    Description    |
|----------------|-----------------|--------------|---------------------------------|
|    api_user    |    String    |  |    API User for new Merchant    |
|    api_key    |    String    |  |    API Key for new Merchant    |

## Headers

- `Content-Type` string

## Request body `*/*`

- string

## Response `200`

Successful response

---

[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)