# Create a customer

**POST /v1/Customers**

Creates a new Customer with the provided CustomerViewModel.
**Available to the roles:** csp, reseller


## Servers
- https://api.cloudcockpit.com: https://api.cloudcockpit.com ()


## Authentication methods
- Bearer auth


## Parameters
### Headers
- **X-Tenant** (string)
  The domain used to access the portal.
- **Authorization** (string)
  JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"
- **X-Correlation-Id** (string(uuid))
  This header is optional and by setting it you can correlate the audit logs made by this request.



### Body: application/json (object)
The customer info to create the customer.
- **id** (string(uuid))
  The GUID identifier for the customer.
- **companyName** (string | null)
  The name of the company. This may be up to 255 characters.
- **taxId** (string | null)
  The company tax Id. This may be up to 255 characters.
- **country** (string | null)
  The company country code in the ISO 3166-1 alpha-2 standard.
- **addressLine1** (string | null)
  The company address line 1. This may be up to 255 characters.
- **addressLine2** (string | null)
  The company address line 2. This may be up to 255 characters.
- **city** (string | null)
  The company city. This may be up to 255 characters.
- **state** (string | null)
  The company State. This may be up to 255 characters.
- **zip** (string | null)
  The company ZIP. This may be up to 30 characters.
- **firstName** (string | null)
  The company primary contact first name. This may be up to 255 characters.
- **middleName** (string | null)
  The company primary contact middle name. This may be up to 255 characters.
- **lastName** (string | null)
  The company primary contact last name. This may be up to 255 characters.
- **email** (string | null)
  The company primary contact email. This may be up to 255 characters.
- **phone** (string | null)
  The company primary contact phone. This may be up to 30 characters.
- **internalIdentifier** (string | null)
  The customer internal identifier. This may be up to 255 characters.
- **resellerId** (string(uuid) | null)
  The reseller identifier. If this value is set a relation between this customer and the reseller will be created, if null a direct relation between the CSP and the customer will be created instead.
- **providerCustomers** (object | null)
  The provider customers. A list containing the info about this customer in one or more provider instances.
- **customerAssociations** (array[object] | null)
  The list of partners associated to a customer


## Responses
### 200
OK

#### Body: application/json (string(uuid))
string(uuid)
### 201
Created

#### Body: application/json (string(uuid))
string(uuid)
### 400
Bad Request

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.

### 401
Unauthorized

### 403
Forbidden

### 500
Internal Server Error

#### Body: application/json (object)
- **statusCode** (integer(int32))
  The HTTP status code that represents a specific error scenario.
- **type** (string | null)
  The type of error that occurred.
- **description** (string | null)
  Describes the error scenario that occurred.
- **correlationId** (string | null)
  The correlationId of the request that originated the error.
- **errors** (array[object] | null)
  A list containing the detail of the errors that occurred in this error scenario.


[Powered by Bump.sh](https://bump.sh)