📂 На этом этапе необходимы:

• Идентификатор воронки <pipeline_id>
   – получаем на этапе ⚠️ 1. Создание воронки
• Идентификаторы статусов <status_id>
   – получаем на этапе ⚠️ 2. Создание статусов для воронки
• Идентификаторы менеджеров <manager_id>
  – получаем на этапе ❎ 3. Создание менеджеров /опционально
• Идентификаторы контактных данных клиентов <contact_id>
   – получаем на этапе ❎ 4. Создаем контакты для пользователей /опционально
• Идентификаторы кастомных полей <field_id>
  — получаем на этапе ❎ 5. Создаем кастомные поля /опционально
  (если передаём в сущность значение этих полей)

Лиды добавляются с помощью метода Create Lead или Create Many Leads

❗ Не забудьте для каждого запроса указывать header Authorization: Token <токен_доступа> полученный на этапе ⚠️ 0. Производим аутентификацию

📤 Пример запроса на создание Лида:

POST https://apps.smartanalytics.io/crm/v1/api/leads/

Request Body:
{
  "outer_id": "123456",
  "name": "Lead #1";
  "pipeline_id": "6179558e7100eeb40997f733",
  "status_id": "617957d87100eeb40997f733",
  "manager_id": "617ab1c20f74ea854cfe8864",
  "contact_id": "617ab29c0f74ea854cfe8865",
  "utm_source": "none",
  "utm_medium": "none",
  "utm_campaign": "none",
  "utm_content": "none",
  "utm_term": "none",
  "metrika_cid": "none",
  "google_cid": "none",
  "smart_visitor_id": "none",
  "price": 0,
  "products": [
    {
      "id": "12321321",
      "name": "Porduct #1",
      "category": "none",
      "quantity": 1,
      "price": 2310
    }
  ],
  "custom_fields": [
    {
      "id": "617aa3eb0f74ea854cfe8222",
      "value": "Ivan"
    }
  ],
  "purchase_tax": 0,
  "purchase_shipping": "Самовывоз",
  "rejection_reason": "Нет нужного товара",
  "first_cost": 0,
  "created": 1635424815,
  "last_modified": 1635424815,
  "invoice": "none",
  "entity_link": "none",
  "customer_phone": "+1809000",
  "customer_email": "gggg@gmail.com"
}

RESPONSE:
{
  "id": "617abbbb0f74ea854cfe8869",
  "name": "Lead #1",
  "pipeline_id": "6179558e7100eeb40997f733",
  "status_id": "617957d87100eeb40997f734",
  "manager_id": "617ab1c20f74ea854cfe8864",
  "contact_id": "617ab29c0f74ea854cfe8865",
  "utm_source": "none",
  "utm_medium": "none",
  "utm_campaign": "none",
  "utm_content": "none",
  "utm_term": "none",
  "metrika_cid": "none",
  "google_cid": "none",
  "smart_visitor_id": "none",
  "price": 0,
  "products": [
    {
      "id": "12321321",
      "name": "Porduct #1",
      "category": "none",
      "quantity": 1,
      "price": 2310
    }
  ],
  "custom_fields": [
    {
      "id": "617aa3eb0f74ea854cfe8222",
      "value": "Ivan"
    }
  ],
  "purchase_tax": 0,
  "purchase_shipping": "Самовывоз",
  "rejection_reason": "Нет нужного товара",
  "first_cost": 0,
  "created": 1635424815,
  "last_modified": 1635424815,
  "invoice": "none",
  "entity_link": "none",
  "customer_phone": "+1809000",
  "customer_email": "gggg@gmail.com"
}

📕 Список всех полей (lead):

Обязательное поле	Название поля в API	Тип поля	Описание поля
Да	name	string (Name)	Название лида
Да	pipeline_id	string (Pipeline Id)	Идентификатор воронки, в которой находится лид
Да	status_id	string (Status Id)	Статус лида
Нет	manager_id	string (Manager Id)	Идентификатор менеджера
Нет	contact_id	string (Contact Id)	Идентификатор “карточки” с контактами
Нет	utm_source	string (Utm Source)	UTM source
Нет	utm_medium	string (Utm Medium)	UTM medium
Нет	utm_campaign	string (Utm Campaign)	UTM campaign
Нет	utm_content	string (Utm Content)	UTM content
Нет	utm_term	string (Utm Term)	UTM term
Нет	metrika_cid	string (Metrika Cid)	Уникальный идентификатор Яндекс метрики
Нет	google_cid	string (Google Cid)	Уникальный идентификатор Гугл аналитикс
Да	price	number (Price)	Итоговая цена в лиде
Да	products	Array of objects (Products)	Массив с позициями лида
Да	custom_fields	Array of objects (Custom Fields)	Кастомные поля для лида
Нет	purchase_tax	number (Purchase Tax)Default: 0	Налог
Нет	purchase_shipping	number (Purchase Shipping)Default: 0	Тип доставки
Нет	rejection_reason	string (Rejection Reason)	Причина отказа
Нет	first_cost	number (First Cost)Default: 0	Себестоимость заказа
Да	created	integer (Created)	Дата создания лида
Да	last_modified	integer (Last Modified)	Дата последнего изменения лида
Нет	invoice	string (Invoice)Default: «none»	Счет на который пришла оплата
Нет	entity_link	string (Entity Link)Default: «none»	Ссылка на лида
Нет	customer_email	string <email> (Customer Email)	Почта
Нет	customer_phone	string (Customer Phone) >= 5 characters	Номер телефона
Нет	outer_id	string (Outer Id)	Внешний идентификатор лида

Поля в массиве products

Обязательное поле	Название поля в API	Тип поля	Описание поля
Нет	id	string (Id)	Идентификатор продукта
Да	name	string (Name)	Название продукта
Да	category	string (Category)	Категория продукта
Да	quantity	integer (Quantity)	Количество элементов конкретного id в лиде
Да	price	number (Price)	Стоимость продукта

Поля в массиве custom_fields

Обязательное поле	Название поля в API	Тип поля	Описание поля
Да	id	string (Id)	Идентификатор кастомного поля
Да	value	any (Value)	Значение кастомного поля

• Контакты крепятся через <contact_id>. Чтобы получить контакты для сделки, надо воспользоваться методом Get Contact и отфильтровать значение по email, phone, full_name
• При передачи данных по лиду рекомендуется передавать <outer_id> (идентификатор из Вашей Системы/Базы данных), чтобы было проще работать с лидами и проводить сверку актуальности данных.

Далее перейти к ⚠️ 7. Создаём сделки (заявки).