# Add provider instance to customer.

**POST /v1/Customers/{customerId}/provider-instances**

**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.

### Path parameters
- **customerId** (string(uuid))
  The customer id.

### Query parameters
- **resellerId** (string(uuid))
  The id of the reseller. Should not be passed if a reseller performs the request.
  A CSP can set the id of a reseller to add a provider instance between that reseller and a customer.

### Body: application/json (object)
The request with the information of the provider instance to add to the customer.
- **providerInstanceId** (string(uuid))
  The GUID identifier for the provider instance.
- **providerCustomerData** (string | null)
  The provider specific data for this customer.
  For a microsoft provider instance the json object needs the following properties:
  - Domain (Example: TestDomain)
  - CredentialsEmail (Example: test@email.com)
  - AcceptedMCA (Example: true)
  - AgreementDate (Example: 2022-12-28T00:00:00Z)
  - KeepPrimaryInformation (Example: true)
  - FirstName (Example: Test)
  - LastName (Example: Test)
  - Email (Example: test@email.com)
  - Phone (Example: 921231231)
  - DefaultCulture (Example: en-US)
  - Language (Example: en)
  - AssociatedPartnerId (Example: 6234552)
  - Qualifications (Example: [])
  - EnableGDAP (Example: true)
- **margin** (object)
  This value object contains the price margin for this entity.
- **offerTypeMargins** (object | null)
  Contains as key the name of the offer type and as value the price margin applied to each offer type for this specific provider instance.
  Price margins applied at the offer type level will override the price margin applied at the provider instance level.
  If no price margin is applied to a specific offer type of this provider instance then it will not be in the dictionary.
  This dictionary is optional.


## Responses
### 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

### 404
Not Found

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