Создать контакт

Запросом создается контакт в Адресную книгу организации.
В заголовке запроса передается USERID сотрудника, в адресную книгу которого нужно добавить этот контакт.

МЕТОД HTTP

POST 

URL

https://userapi.mts-link.ru/v3/users/{userID}/contacts

ОБЯЗАТЕЛЬНЫЕ ПАРАМЕТРЫ

• email — электронная почта контакта.  Уникальный идентификатор контакта. Невозможно создать двух людей с одной почтой. При попытке создания контакта с уже существующим email в ответе на запрос будет ошибка — 409.

ДОПОЛНИТЕЛЬНЫЕ ПАРАМЕТРЫ

• name — имя;

• secondName — фамилия;

• company — организация, в которой работает пользователь;

• position — должность;

• phoneMain — телефон;

• tags[] — личные теги контакта. Передается как массив тегов, которые будут прикреплены к контакту при создании;

• publicTags[] — публичные теги контакта, которые будут доступны всем сотрудникам Организации. Передается аналогично, как массив тегов;

• photo — фото участника. Можно передать либо ссылку на картинку, либо fileID картинки из файлового менеджера Организации.

ПОЛЯ ОТВЕТА

• id — contactID созданного контакта;

• avatar — ссылка на фото контакта;

• thumbnails — ссылки на миниатюры фото контакта. В пользовательских сценариях не используются.

ПРИМЕР ЗАПРОСА

url: https://userapi.mts-link.ru/v3/users/{userID}/contacts,
method: POST,
headers: 
{
    x-auth-token: {Token},
    Content-Type: application/x-www-form-urlencoded
},
data: 
{
    email: i.ivanchenko@webinar.ru,
    name: Иван,
    secondName: Иванченко,
    company: Вебинар,
    position: Менеджер по работе с клиентами,
    phoneMain: 88003505490,
    tags[0]: Сотрудник,
    photo: 1245282
};

ПРИМЕР ОТВЕТА

  201  -  Created
{     
   "id": 308925039,     
   "avatar": {         
   "url": "https://events-storage.webinar.ru/api-storage/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",         
    "thumbnails": {             
    "640x1920": "https://events-storage.webinar.ru/api-storage/640x1920/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "1920x1080": "https://events-storage.webinar.ru/api-storage/1920x1080/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "1333x1000": "https://events-storage.webinar.ru/api-storage/1333x1000/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",              
    "224x199": "https://events-storage.webinar.ru/api-storage/224x199/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "200x50": "https://events-storage.webinar.ru/api-storage/200x50/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "50x50": "https://events-storage.webinar.ru/api-storage/50x50/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "34x34": "https://events-storage.webinar.ru/api-storage/34x34/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "148x112": "https://events-storage.webinar.ru/api-storage/148x112/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "540x960": "https://events-storage.webinar.ru/api-storage/540x960/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "360x640": "https://events-storage.webinar.ru/api-storage/360x640/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "180x320": "https://events-storage.webinar.ru/api-storage/180x320/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "960x540": "https://events-storage.webinar.ru/api-storage/960x540/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "640x360": "https://events-storage.webinar.ru/api-storage/640x360/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png",             
    "320x180": "https://events-storage.webinar.ru/api-storage/320x180/files/webinar/2025/08/11/08e9bda210f45d86bb5f57af94a4f3507038d8c5934db384ff5ff65cb55.png"         
   }     
}