# Update/create customer by id

Endpoint: PUT /customers/{customerId}
Version: 1.0.0
Security: M2X_auth_application

## Path parameters:

  - `customerId` (string, required)
    The customer Id

## Request fields (application/json):

  - `name` (string, required)
    Example: "My customer"

  - `externalId` (string)
    Rapid searchable id for front end users
    Example: "C123"

  - `integrationId` (string)
    Customer Integration Id
    Example: "123-123-123"

  - `postalAddress` (string)
    Address used to differentiate similar customers in the front end
    Example: "40 test street"

  - `email` (string)
    Example: "email@test.com"

  - `contactFirstName` (string)
    Example: "Joe"

  - `contactLastName` (string)
    Example: "Blog"

  - `businessPhone` (string)
    Example: "000 000 00"

  - `businessMobilePhone` (string)
    Example: "000 000 00"

  - `disabled` (boolean)
    Whether the customer is searchable in the front end

  - `onHold` (boolean)

## Response 200 fields (application/json):

  - `id` (string)
    Example: "customer123"

  - `name` (string)
    Example: "My customer"

  - `externalId` (string,null)
    Rapid searchable id for front end users
    Example: "C123"

  - `integrationId` (string)
    Customer Integration Id
    Example: "123-123-123"

  - `postalAddress` (string,null)
    Address used to differentiate similar customers in the front end
    Example: "40 test street"

  - `email` (string,null)
    Example: "email@test.com"

  - `contactFirstName` (string,null)
    Example: "Joe"

  - `contactLastName` (string,null)
    Example: "Blog"

  - `businessPhone` (string,null)
    Example: "000 000 00"

  - `businessMobilePhone` (string,null)
    Example: "000 000 00"

  - `disabled` (boolean)
    Whether the customer is searchable in the front end

  - `onHold` (boolean)

## Response 400 fields (application/json):

  - `message` (string)
    Example: "missing data"