---
title: "🔒 Update contact person V3"
method: PATCH
path: "/api/v3/customers/{customerId}/contactPersons/{contactPersonId}"
tags: ["Customer"]
---

# 🔒 Update contact person V3

`PATCH /api/v3/customers/{customerId}/contactPersons/{contactPersonId}`

This endpoint is currently in Beta and available for testing. It may contain bugs, and breaking changes can occur at any time without prior notice. We do not recommend using Beta endpoints in production environments. Should you choose to use it in production, you assume full responsibility for any resulting issues.

This endpoint requires the following scopes: `customer:update`.

Update an existing contact person for a customer.

## Path parameters

- `customerId` string, required
- `contactPersonId` string, required

## Request body

- object
  - `type` 'mrs' | 'mr' | 'company' | 'other' — Type of contact person
  - `name` string — Name of contact person
  - `title` string — Title of contact person
  - `salutation` string — Salutation of contact person
  - `department` string — Department of contact person
  - `subDepartment` string — Sub-Department of contact person
  - `street` string — Street of contact person address
  - `addressSupplement` string — Address supplement of contact person address
  - `zipCode` string — Zip code of contact person address
  - `city` string — City of contact person address
  - `state` string — State of contact person address
  - `country` string — Country of contact person address (ISO-3166-1 alpha-2)
  - `phone` string — Phone number of contact person
  - `mobile` string — Mobile number of contact person
  - `fax` string — Fax number of contact person
  - `email` string, email — Email address of contact person
  - `contactPersonDetails` object — Additional details for the contact person
    - `position` string — Position or role of the contact person
    - `birthday` string, date — Birthday of the contact person in YYYY-MM-DD format
    - `language` string — Preferred language code (2-letter ISO 639-1 code, will be uppercased)
    - `allowMarketingEmails` boolean — Whether the contact person allows marketing emails
    - `internalNote` string — Internal note about the contact person
    - `remarks` string — Additional remarks about the contact person
  - `groups` object[] — Groups to assign contact person to. Pass an empty array to clear all groups.
    - `id` string, required — Group ID

## Response `200`

Update an existing contact person for a customer.

- object
  - `data` object — Contact Person object
    - `id` string — ID of contact person
    - `type` 'mrs' | 'mr' | 'company' | 'other' — Type of contact person
    - `name` string — Name of contact person
    - `title` string — Title of contact person
    - `salutation` string — Salutation of contact person
    - `department` string — Department of contact person
    - `subDepartment` string — Sub-Department of contact person
    - `street` string — Street of contact person address
    - `addressSupplement` string — Address supplement of contact person address
    - `zipCode` string — Zip code of contact person address
    - `city` string — City of contact person address
    - `country` string — Country of contact person address
    - `state` string — State of contact person address
    - `phone` string — Phone number of contact person
    - `mobile` string — Mobile number of contact person
    - `fax` string — Fax number of contact person
    - `email` string — Email address of contact person
    - `contactPersonDetails` object — Contact person details
      - `position` string
      - `birthday` string, date
      - `language` string
      - `allowMarketingEmails` boolean
      - `internalNote` string
      - `remarks` string
    - `groups` object[] — Group information
      - `id` string — ID of group
    - `createdAt` string, date-time — Creation timestamp
    - `updatedAt` string, date-time — Last update timestamp

## Other responses

- `400` — Failed validation
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.net/xentral/apis/xentral-api.md) · [All operations](https://skmtc.net/xentral/apis/xentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xentral/xentral-api/revisions/8a27ba392442/schema)