Изменить клиента
Меняет только переданные поля. Новый phone становится основным телефоном, прежний остаётся у клиента дополнительным. Телефон другого клиента даёт ответ 409, и тогда ничего не меняется. Право: customers:write.
bearerApiKeyАвторизацияBearer <ключ>Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API-ключи.
id*stringID клиента в Рефсейлс.
application/json- body
name?|Имя. null стирает.
email?|Email. null стирает.
phone?stringНовый основной телефон. Прежний остаётся у клиента дополнительным номером.
1 <= length <= 50notes?|Заметка менеджера. null стирает.
Клиент после изменения.
application/json- response
data*curl -X PATCH "https://example.com/api/v1/customers/string" \ -H "Content-Type: application/json" \ -d '{ "email": "customer.new@example.com", "phone": "+7 900 000-00-01" }'{ "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", "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" }}Найти или создать клиента POST
Ищет клиента так же, как при создании заказа: сначала по telegramId, потом по телефону, потом по email. Одно имя клиента не находит. Если клиент найден, ответ 200: у него заполнятся только пустые поля. Если нет, клиент создаётся с ответом 201. Нужно хотя бы одно из полей name, phone, email, telegramId. Право: customers:write.
Удалить клиента DELETE
Убирает клиента из списков. Его заказы и переписка остаются, телефоны освобождаются для нового клиента. Право: customers:write.