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