---
title: "Update customer"
method: PATCH
path: "/customers/{customerId}"
---

# Update customer

`PATCH /customers/{customerId}`

## Request

- Base URL: `https://api.sandbox.cleeng.com/3.1`
- URL: `https://api.sandbox.cleeng.com/3.1/customers/{customerId}`
- Auth: API key in header `X-Publisher-Token`

Use this endpoint to update a customer's data, for example first name, last name.

## Path parameters

- `customerId` string, required

## Headers

- `Content-Type` string

## Request body

- object
  - `firstName` string: New customer first name
  - `lastName` string: New customer last name
  - `country` string: New customer country
  - `email` string: New customer email address. The `.invalid` domain is supported for customers without an email address (for example `user123@yourdomain.invalid`). See [How to handle customers without an email address](https://publisher.support.cleeng.com/hc/en-us/articles/28616088003868-How-to-handle-customers-without-an-email-address).
  - `externalId` string: Customer's external ID
  - `externalData` string: Custom data in JSON format
  - `lastUserIp` string: Customer IP address. Both IPv4 and IPv6 addresses are accepted.
  - `lastLoginDate` integer: Customer's last login date as unix timestamp
  - `locale` string: Defines language and text formatting for the user. E.g. "en_US", "fr_FR"
  - `currency` string: Customer's currency. E.g. "USD", "EUR" (see the list of [supported currencies](https://publisher.support.cleeng.com/hc/en-us/articles/217887888-Supported-Currencies)).
  - `password` string: New customer password. String containing at least one letter and one digit or special character (!@#$%^&), length - 8-80 characters. Using this parameter will update the customer password without triggering email communication.
  - `taxIdentifier` string: The customer's tax identification number, e.g. a Brazilian CPF. Length 2–20. Example: `39053344705`
  - `phoneNumber` string: The customer's contact phone number. Length 2–20. Allowed characters only: digits and `+ - space ( ) .` Example: `+55 11 91234-5678`
  - `address` string: First line of the customer's street address. Non-empty when supplied. Example: `Avenida Paulista 1578`
  - `address2` string: Second line of the customer's address (apartment, suite, unit, etc.). Non-empty when supplied. Example: `Conjunto 42`
  - `dependentLocality` string: District within the city. Length 2–100. Example: `Bela Vista`
  - `city` string: City or town of the address. Example: `São Paulo`
  - `state` string: State, province, or region. Length 2–50. Example: `BR-SP`
  - `postalCode` string: Postal / ZIP code of the address. Length 2–20, upper-cased, validated against the country sent in the same request. Example: `01310-100`

## Response `200`

200

- object
  - `success` boolean
  - `data` object
    - `id` integer
    - `email` string
    - `country` string
    - `regDate` string
    - `lastLoginDate` string
    - `lastUserIp` string
    - `currency` string
    - `locale` string
    - `firstName` string
    - `lastName` string
    - `externalId` string
    - `externalData` unknown[]
      - unknown
  - `message` string

---

[API](https://skmtc.dev/cleeng/apis/api-31.md) - [All operations](https://skmtc.dev/cleeng/apis/api-31/llms.txt) - [OpenAPI document](https://skmtc.dev/cleeng/apis/api-31/revisions/df55396cda4f?raw)