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

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

POST
/api/v1/customers

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

Авторизация

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

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

Тело запроса

application/json
  1. body
name?|

Имя.

email?|

Email.

phone?|

Телефон в любом формате: +7 900 000-00-00, 89000000000.

telegramId?|null
notes?|

Заметка менеджера. Найденному клиенту запишется, только если заметки у него ещё нет.

birthday?

День рождения. Найденному клиенту запишется, только если дата у него ещё не указана.

Ответ

Клиент уже был, возвращён он.

application/json
  1. response
data*
Example Request
curl -X POST 'https://refsales.ru/api/v1/customers' \  -H 'Content-Type: application/json' \  -d '{  "name": "Иван Петров",  "phone": "+7 900 000-00-00",  "email": "customer@example.com",  "notes": "Предпочитает доставку после 18:00",  "birthday": {    "day": 12,    "month": 3  }}'
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"  }}