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

Найти или создать клиента

POST
/api/v1/customers

Ищет клиента так же, как при создании заказа: сначала по telegramId, потом по телефону, потом по email. Одно имя клиента не находит. Если клиент найден, ответ 200: у него заполнятся только пустые поля. Если нет, клиент создаётся с ответом 201. Нужно хотя бы одно из полей name, phone, email, telegramId. Право: customers:write.

Авторизация

bearerApiKey
АвторизацияBearer <ключ>

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

Где: header

Тело запроса

application/json

Типы TypeScript

Готовый тип для вашего кода.

Ответ

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/customers" \  -H "Content-Type: application/json" \  -d '{    "name": "Анна Смирнова",    "phone": "+7 916 123-45-67",    "email": "anna@example.ru",    "notes": "Предпочитает доставку после 18:00"  }'
{  "data": {    "id": "2c8e4a1f-9b3d-4f7e-a6c0-5d1b8e3f2a96",    "name": "Анна Смирнова",    "email": "anna@example.ru",    "phone": "+7 (916) 123-45-67",    "phoneDigits": "79161234567",    "telegramId": "5123456789",    "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.