v1

latestOpenAPI 3.0.2EULA2026-07-143221521.2 MB
Customers

Update a customer

Update the information on a specific customer account.

Replaces the customer's personal information, contact details, address, consent records, and optional property records with the values provided in the request body. The customer password is changed only if a new password is provided; omitting the password field leaves it unchanged.

To update multiple custom property records in bulk without affecting other customer data, use POST /customers/{customer_id}/properties/batch.

put/customers/{customer_id}

Path parameters

customer_idstring required

The unique ID of the customer.

Headers

Accept-Languagestring

The unique ID of the language code by ISO 639-1.

Request body

passwordstring password

This is the customer’s password. The parameter does not follow the usual PUT request rules. If you do not include it, the password will not change.

Example request

{
  "customer": {
    "customer_id": "8ea2591121e636086a4a9c0992",
    "personal_information": {
      "salutation": "Dear Mr. Smith",
      "gender": 1,
      "first_name": "John",
      "last_name": "Smith",
      "pre_nominals": "Dr.",
      "post_nominals": "Ph.D",
      "birthdate": "1985-02-12",
      "email": "happy_customer@crmcarecloud.com",
      "phone": "420523828931",
      "language_id": "en",
      "store_id": "8bed991c68a4",
      "photo_url": "https://example.com/photos/customer.jpg",
      "address": {
        "address1": "Old Town Square",
        "address2": "34",
        "address3": "1a",
        "zip": "11000",
        "city": "Prague 1",
        "country_code": "cz"
      },
      "agreement": {
        "agreement_gtc": 1,
        "agreement_profiling": 1,
        "agreement_marketing_communication": 1,
        "custom_agreements": [
          {
            "agreement_id": "8fd73167342d06899c4c015320",
            "agreement_value": 2
          }
        ]
      },
      "consents": [
        {
          "consent_id": "8fd73167342d06899c4c015320",
          "consent_value": 2,
          "last_change": "2024-06-23 11:47:23"
        }
      ]
    },
    "doi_email": "2019-06-23 11:47:22",
    "doi_phone": "2019-06-23 11:47:23",
    "last_change": "2019-06-23 11:47:23",
    "state": 1
  },
  "password": "fbsdfbkjebf$2,4d4fnb#,ds4@fnm,2dsf6sa",
  "social_network_credentials": {
    "social_network_id": "twitter",
    "social_network_token": "38e123j1jedu12d1jnjqwd"
  },
  "property_records": [
    {
      "property_record_id": "docasna_blokace_darce_do:8ea2591121e636086a4a9c0992",
      "property_id": "docasna_blokace_darce_do",
      "property_name": "Property #6",
      "last_change": "2023-02-02 00:00:00"
    }
  ]
}

Response

No Content