---
title: "Create a new contact communication way"
method: POST
path: "/CommunicationWay"
tags: ["CommunicationWay"]
---

# Create a new contact communication way

`POST /CommunicationWay`

Creates a new contact communication way.

## Request body

- ModelCommunicationWay — Contact communication way model
  - `id` integer — The communication way id
  - `objectName` string — The communication way object name
  - `create` string, date-time — Date of communication way creation
  - `update` string, date-time — Date of last communication way update
  - `contact` object — The contact to which this communication way belongs.
    - `id` integer, required — Unique identifier of the contact
    - `objectName` string, required — Model name, which is 'Contact'
  - `type` 'EMAIL' | 'PHONE' | 'WEB' | 'MOBILE', required — Type of the communication way
  - `value` string, required — The value of the communication way.<br> For example the phone number, e-mail address or website.
  - `key` object, required — The key of the communication way.<br> Similar to the category of addresses.<br> For all communication way keys please send a GET to /CommunicationWayKey.
    - `id` integer, required — Unique identifier of the key
    - `objectName` string, required — Model name, which is 'CommunicationWayKey'
  - `main` boolean, nullable — Defines whether the communication way is the main communication way for the contact.
  - `sevClient` object — Client to which communication way key belongs. Will be filled automatically
    - `id` integer, required — Unique identifier of the client
    - `objectName` string, required — Model name, which is 'SevClient'

## Response `201`

Created - Returns created contact communication way

- ModelCommunicationWayResponse — Contact communication way model
  - `id` string — The communication way id
  - `objectName` string — The communication way object name
  - `create` string, date-time — Date of communication way creation
  - `update` string, date-time — Date of last communication way update
  - `contact` object — The contact to which this communication way belongs.
    - `id` string, required — Unique identifier of the contact
    - `objectName` string, required — Model name, which is 'Contact'
  - `type` 'EMAIL' | 'PHONE' | 'WEB' | 'MOBILE' — Type of the communication way
  - `value` string — The value of the communication way.<br> For example the phone number, e-mail address or website.
  - `key` object — The key of the communication way.<br> Similar to the category of addresses.<br> For all communication way keys please send a GET to /CommunicationWayKey.
    - `id` string, required — Unique identifier of the key
    - `objectName` string, required — Model name, which is 'CommunicationWayKey'
  - `main` string — Defines whether the communication way is the main communication way for the contact.
  - `sevClient` object — Client to which communication way key belongs. Will be filled automatically
    - `id` string, required — Unique identifier of the client
    - `objectName` string, required — Model name, which is 'SevClient'

## Other responses

- `400` — Bad request
- `401` — Authentication required
- `500` — Server Error

---

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