Запросом создается контакт в Адресную книгу организации.
В заголовке запроса передается 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": 49381799,
  "avatar": {
    "url": "https://events-storage.webinar.ru/api-storage/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
    "thumbnails": {
      "640x1920": "https://events-storage.webinar.ru/api-storage/640x1920/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "1920x1080": "https://events-storage.webinar.ru/api-storage/1920x1080/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "1333x1000": "https://events-storage.webinar.ru/api-storage/1333x1000/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "224x199": "https://events-storage.webinar.ru/api-storage/224x199/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "200x50": "https://events-storage.webinar.ru/api-storage/200x50/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "50x50": "https://events-storage.webinar.ru/api-storage/50x50/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "34x34": "https://events-storage.webinar.ru/api-storage/34x34/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg",
      "148x112": "https://events-storage.webinar.ru/api-storage/148x112/files/webinar/2016/05/23/PXYRMihxEgEDH613IiIp6DCvIIcAGsXZcpPJr8hj9oP1Ojz4.jpg"
    }
  }
}