Метод для создания нового контакта в базе вашей компании.
В Пачке присутствует уникальность телефонных номеров в активной базе контактов (телефонные номера в архивных контактах не учитываются). Если вы пытаетесь создать контакт с телефоном, который уже указан у какого-то активного контакта в базе - вы получите ошибку и информацию об этом контакте.
Вы можете заполнять дополнительные поля контакта, которые созданы в вашей компании. Получить актуальный список идентификаторов дополнительных полей контакта вы можете в методе Список дополнительных полей.
Запрос
|
|||
---|---|---|---|
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"
}
]
}
}