Новый контакт

Метод для создания нового контакта в базе вашей компании.

В Пачке присутствует уникальность телефонных номеров в активной базе контактов (телефонные номера в архивных контактах не учитываются). Если вы пытаетесь создать контакт с телефоном, который уже указан у какого-то активного контакта в базе - вы получите ошибку и информацию об этом контакте.

Вы можете заполнять дополнительные поля контакта, которые созданы в вашей компании. Получить актуальный список идентификаторов дополнительных полей контакта вы можете в методе Список дополнительных полей.

post /clients создание нового контакта
Запрос
client object* Собранный объект параметров создаваемого контакта
full_name string* Полное имя
phones array of strings Массив телефонных номеров
emails array of strings Массив электронных адресов
address string Адрес
organization_id integer Идентификатор организации, привязываемой к контакту
additional string Дополнительно
list_tags array of strings Массив списков, привязываемых к контакту
custom_properties array of objects Задаваемые дополнительные поля
id integer Идентификатор дополнительного поля контакта
value string Устанавливаемое значение
Ответ
data object Созданный контакт
id integer Идентификатор созданного контакта
client_number integer Номер контакта в базе
full_name string Полное имя
owner_id integer Идентификатор сотрудника, создавшего контакт
created_at string Дата и время создания контакта (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
phones array of strings Массив телефонных номеров
emails array of strings Массив электронных адресов
address string Адрес
organization_id integer Идентификатор организации, привязанной к контакту
additional string Дополнительно
list_tags array of strings Массив списков, привязанных к контакту
custom_properties array of objects Дополнительные поля созданного контакта
id integer Идентификатор поля
name string Название поля
data_type string Тип поля (string, number, date или link)
value string Значение
Возможные ошибки запроса (errors code)
blank Обязательное поле (не может быть пустым)
too_long Слишком длинное значение (пояснения вы получите в поле message)
invalid Поле не соответствует правилам (пояснения вы получите в поле message)
already_exists Указанный телефонный номер уже есть в базе контактов (найденный контакт с таким номером телефона вы получите в поле payload)
not_found Не удалось найти
invalid Поле имеет неверный формат (идентификатор поля вы получите в поле payload)
{
  "client": {
    "full_name": "Glenn M Jackson",
    "phones": [
      "404-550-6227"
    ],
    "emails": [
      "john@example.com"
    ],
    "address": "4447  Mount Olive Road",
    "additional": "generated at fakeaddressgenerator",
    "list_tags": [
      "fake",
      "fun"
    ],
    "custom_properties": [
      {
        "id": 1021,
        "value": "Hyundai Solaris"
      }
    ]
  }
}
{
  "data": {
    "id": 3609,
    "client_number": "00001",
    "owner_id": 226,
    "created_at": "2020-04-22T12:32:29.000Z",
    "full_name": "Glenn M Jackson",
    "phones": [
      "404-550-6227"
    ],
    "emails": [
      "john@example.com"
    ],
    "address": "4447  Mount Olive Road",
    "organization_id": null,
    "additional": "generated at fakeaddressgenerator",
    "list_tags": [
      "fake",
      "fun"
    ],
    "custom_properties": [
      {
        "id": 1021,
        "name": "Car",
        "data_type": "string",
        "value": "Hyundai Solaris"
      }
    ]
  }
}