---
title: "Updates a CustomerContact"
method: PUT
path: "/core/latest/customers/{customer-id}/contacts/{contact-id}"
tags: ["Customer"]
---

# Updates a CustomerContact

`PUT /core/latest/customers/{customer-id}/contacts/{contact-id}`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/core/latest/customers/{customer-id}/contacts/{contact-id}`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

## Path parameters

- `contact-id` string, required
- `customer-id` string, required

## Request body

- CustomerContact: A customer's contact.
  - `id` string: Id of this contact. Does not need to be included when creating CustomerContact
  - `imageId` string: Id of this contact's image. Does not need to be included when creating CustomerContact
  - `salutation` 'MALE' | 'FEMALE' | 'MALE_FEMALE' | 'FAMILY': Salutation for this contact
  - `firstName` string, required: First name of this contact
  - `lastName` string, required: Last name of this contact
  - `email` string: Email of this contact
  - `website` string: Website of this contact
  - `additionalAddressDefinition` string: Additional address definition of this contact
  - `phones` Phone[]: Phone number list of this contact
    - `id` string: Id of this Phone. <strong>Does not need to be included</strong> when creating customer.
    - `phoneNumber` string, required
    - `type` 'PRIVATE' | 'OFFICE' | 'FAX' | 'WORK' | 'MOBILE', required: Type of this phone number. For company, only <strong>OFFICE</strong> type is supported. The full set of accepted values is the PhoneType schema.
  - `categories` string[]: Category list of this contact
  - `onlinePlatforms` OnlinePlatform[]: The list of online platforms that this contact uses
    - `id` string: Id of this Online platform. Does not need to be included when creating Customer.
    - `platformName` 'FACEBOOK' | 'GOOGLE_PLUS' | 'INSTAGRAM' | 'LINKEDIN' | 'PINTEREST' | 'SKYPE' | 'SNAPCHAT' | 'TWITTER' | 'WHATSAPP' | 'XING' | 'YOUTUBE': Name of the platform that this customer uses
    - `platformValue` string: Url of customer's online platform/webpage
  - `customFields` CustomField[]: The list of custom information of this contact
    - `id` string: Id of this custom field. Does not need to be included when creating CustomerContact
    - `customName` string: name of this custom field
    - `customValue` string: value of this custom field
  - `function` string: Function of this contact
  - `birthday` string, date: Birth date of this person in ISO 8601 format (yyyy-mm-dd)
  - `note` string: Note of this contact

## Response `200`

Updated contact

- CustomerContact: A customer's contact.
  - `id` string: Id of this contact. Does not need to be included when creating CustomerContact
  - `imageId` string: Id of this contact's image. Does not need to be included when creating CustomerContact
  - `salutation` 'MALE' | 'FEMALE' | 'MALE_FEMALE' | 'FAMILY': Salutation for this contact
  - `firstName` string, required: First name of this contact
  - `lastName` string, required: Last name of this contact
  - `email` string: Email of this contact
  - `website` string: Website of this contact
  - `additionalAddressDefinition` string: Additional address definition of this contact
  - `phones` Phone[]: Phone number list of this contact
    - `id` string: Id of this Phone. <strong>Does not need to be included</strong> when creating customer.
    - `phoneNumber` string, required
    - `type` 'PRIVATE' | 'OFFICE' | 'FAX' | 'WORK' | 'MOBILE', required: Type of this phone number. For company, only <strong>OFFICE</strong> type is supported. The full set of accepted values is the PhoneType schema.
  - `categories` string[]: Category list of this contact
  - `onlinePlatforms` OnlinePlatform[]: The list of online platforms that this contact uses
    - `id` string: Id of this Online platform. Does not need to be included when creating Customer.
    - `platformName` 'FACEBOOK' | 'GOOGLE_PLUS' | 'INSTAGRAM' | 'LINKEDIN' | 'PINTEREST' | 'SKYPE' | 'SNAPCHAT' | 'TWITTER' | 'WHATSAPP' | 'XING' | 'YOUTUBE': Name of the platform that this customer uses
    - `platformValue` string: Url of customer's online platform/webpage
  - `customFields` CustomField[]: The list of custom information of this contact
    - `id` string: Id of this custom field. Does not need to be included when creating CustomerContact
    - `customName` string: name of this custom field
    - `customValue` string: value of this custom field
  - `function` string: Function of this contact
  - `birthday` string, date: Birth date of this person in ISO 8601 format (yyyy-mm-dd)
  - `note` string: Note of this contact

## Other responses

- `400`: Data invalid<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `401`: No Authorization header found or invalid token<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `403`: The current user is not allowed to access this company data<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `404`: Resource not found<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `429`: API rate limit exceeded<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.

---

[API](https://skmtc.dev/klara/apis/klara-public-api.md) · [All operations](https://skmtc.dev/klara/apis/klara-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klara/apis/klara-public-api/revisions/490b1a879fc2?raw)
