Обновление

Частичное обновление контактного лица

POST https://do.freshoffice.ru/contact/update

Меняются только переданные поля — всё остальное остаётся как было. При изменении фамилии, имени или отчества полное имя в карточке пересобирается автоматически.

Телефоны и email-адреса обновляются отдельными методами — см. страницу Телефоны и Email (передать contact_id).

Request Body

Name Type Description
id* Int ID контактного лица
company_id* Int ID контрагента (для проверки прав доступа)
first_name String Имя
last_name String Фамилия
middle_name String Отчество
position String Должность
note String Примечание (заменяет старое)
status_id Int Код статуса контактного лица 
{
    "id" : 186442,
    "company_id" : 368132,
    "position" : "Коммерческий директор",
    "note" : "Сменил должность в августе 2026"
}

Примечание

Обязательные параметры — id и company_id, плюс хотя бы одно обновляемое поле.

Пример

curl --location --request POST 'https://do.freshoffice.ru/contact/update' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id" : 186442,
    "company_id" : 368132,
    "position" : "Коммерческий директор"
  }
  '

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://do.freshoffice.ru/contact/update',
  'headers': {
    'Authorization': 'Bearer XXXX-XXXXXXX-XXXXXXX',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "id": 186442,
    "company_id": 368132,
    "position": "Коммерческий директор"
  })
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Ответ

{
  "status": "success",
  "error": "",
  "code": null,
  "rows": 0,
  "pages": 0,
  "page": 0,
  "value": "1"
}
// value: 1 - контактное лицо обновлено, 0 - ошибка (текст в поле error)
Предыдущая
Добавление
Следующая
Телефоны и Email