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

# 🔒 Create contact person V3

`POST /api/v3/customers/{customerId}/contactPersons`

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:create`.

Create a new contact person for a customer.

## Path parameters

- `customerId` string, required

## Request body

- object
  - `type` 'mrs' | 'mr' | 'company' | 'other' — Type of contact person
  - `name` string, required — 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 — Contact person details
    - `position` string — Position/job function of contact person
    - `birthday` string, date — Birthday of contact person
    - `language` string — Preferred language code
    - `allowMarketingEmails` boolean — Whether marketing emails are allowed
    - `internalNote` string — Internal note (staff-only)
    - `remarks` string — Additional remarks
  - `groups` object[] — Groups to assign contact person to
    - `id` string, required — Group ID

## Response `201`

Create a new 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)