Рефсейлс API
Клиенты

Изменить клиента

PATCH
/api/v1/customers/{id}

Меняет только переданные поля. Новый phone становится основным телефоном, прежний остаётся у клиента дополнительным. Телефон другого клиента даёт ответ 409, и тогда ничего не меняется. Право: customers:write.

Авторизация

bearerApiKey
headerАвторизацияBearer <rsk_live_…>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API и вебхуки.

id*string

ID клиента в Рефсейлс.

Тело запроса

application/json
  1. body
name?|

Имя. null стирает.

email?|

Email. null стирает.

phone?string

Новый основной телефон. Прежний остаётся у клиента дополнительным номером.

Length1 <= length <= 50
notes?|

Заметка менеджера. null стирает.

birthday?|

День рождения. null стирает.

Ответ

Клиент после изменения.

application/json
  1. response
data*
Example Request
curl -X PATCH 'https://refsales.ru/api/v1/customers/string' \  -H 'Content-Type: application/json' \  -d '{  "email": "customer.new@example.com",  "phone": "+7 900 000-00-01"}'
Example Response
{  "data": {    "id": "2c8e4a1f-9b3d-4f7e-a6c0-5d1b8e3f2a96",    "name": "Иван Петров",    "email": "customer@example.com",    "phone": "+7 (900) 000-00-00",    "phoneDigits": "79000000000",    "telegramId": "123456789",    "source": "order",    "notes": "Предпочитает доставку после 18:00",    "birthday": {      "day": 12,      "month": 3,      "year": null    },    "totalOrders": 4,    "totalRevenue": 1164000,    "firstSeenAt": "2026-03-02T10:21:00.418265+00:00",    "lastOrderAt": "2026-09-12T09:41:07.418265+00:00",    "createdAt": "2026-03-02T10:21:00.418265+00:00",    "updatedAt": "2026-09-12T09:41:07.418265+00:00"  }}