---
title: "Create contact person"
method: POST
path: "/api/v1/customers/{customerId}/contactPerson"
tags: ["Customer - Contact Person"]
---

# Create contact person

`POST /api/v1/customers/{customerId}/contactPerson`

Creates new contact person for given customer.

## Path parameters

- `customerId` string, required — Resource identifier.

## Request body

- object
  - `type` 'company' | 'mr' | 'mrs' | 'other', nullable — Type of contact used later for salutations
  - `name` string, required — Full name of the contact person
  - `title` string, nullable — Additional information used for salutations
  - `birthday` string, date, nullable
  - `birthdayShowInCalendar` boolean, nullable — Decides wether or not to show in birthday calendar
  - `sendBirthdayCard` boolean, nullable — Decides wether or not to send birthday card via serial letter module
  - `marketingBan` boolean, nullable — Decides wether or not to send serial letters to this contact
  - `department` string, nullable — Department of contact if necessary and available
  - `subDepartment` string, nullable — Sub-Department of contact if necessary and available
  - `position` string, nullable — Position or responsibility
  - `language` string, nullable — Two-letter ISO 639-1 code (uppercase or lowercase allowed).
  - `address` object
    - `street` string, nullable — Street + number of contact address
    - `additionalStreet` string, nullable — Address suffix
    - `zip` string, nullable — ZIP code of contact address
    - `city` string, nullable — City of contact address
    - `state` string, nullable — Federal state / district of contact address
    - `country` string, nullable — ISO 3166-1 (Alpha 2) Code of contact address country
  - `contact` object
    - `phone` string, nullable — Phone number of contact address
    - `fax` string, nullable — Fax number of contact address
    - `mobile` string, nullable — Mobile number of contact address
    - `salutation` string, nullable — Specifies dedicated salutation
    - `email` string, email, nullable — E-mail address
  - `groups` string[] — List of groups this contact person is belong to
  - `comment` string, nullable — Internal comment for this contact
  - `others` string, nullable — Every other information you deem relevant

## Response `201`

Resource successfully created response

## Other responses

- `400` — IETF RFC 9457 Problem API compliant response
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `404` — Resource was not found or not enough access privileges
- `415` — Resource representation send in the request is not supported.

---

[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)