/leads/campaign/{campaignId} Аутентификация
Передавайте API-ключ организации как Bearer-токен.
Authorization: Bearer YOUR_API_KEY Параметры пути
campaignId string обязательное UUID рассылки
550e8400-e29b-41d4-a716-446655440000 Параметры запроса
after_id number Курсор поиска по страницам. Возвращает лиды с ID, превышающим это значение.
Диапазон: x ≥ 1
100 offset number Смещение пагинации. Должно быть 0 или больше.
Диапазон: x ≥ 0
0 limit number Лимит пагинации. Допустимое значение — от 1 до 200.
Диапазон: x ≥ 1, x ≤ 200
50 search string Строка поиска email без учета регистра.
john Ответ
application/json Лиды успешно получены
total number обязательное Общее количество лидов, соответствующих запросу
125 offset number обязательное Смещение пагинации
0 limit number обязательное Ограничение на количество страниц
50 items object[] обязательное Страница лидов
Показать вложенные поля
items.id number обязательное ID лида
1 items.email string обязательное Адрес email лида
john.doe@example.com items.first_name string обязательное Имя ведущего
John items.last_name string обязательное Фамилия ведущего
Doe items.company string обязательное Компания ведущего
OpenAI items.website string обязательное Сайт ведущего
https://openai.com items.personalization string обязательное Текст персонализации
Hi John, I saw you work at OpenAI… items.sender string обязательное Учетная запись email, с которой было отправлено письмо
outbound@coldy.ai items.verification_status string обязательное Статус проверки email
Допустимые значения: valid, unknown, accept_all, invalid, disposable, not_verified
valid items.status string обязательное Текущий статус лида
Допустимые значения: Not contacted, Sent, Bounce, Replied, Opened
Not contacted items.campaign_id string обязательное ID связанной рассылки
550e8400-e29b-41d4-a716-446655440000 items.id_previous_sending_sequence number обязательное ID предыдущей цепочки писем отправки
0 items.amount_sequences_sent number обязательное Количество уже отправленных цепочек писем
2 items.date_last_sequence_send string обязательное Дата последней отправленной цепочки писем
2025-10-01T12:34:56.000Z items.reply_text string обязательное Текст ответа, если лид ответил
Sure, let’s talk next week. items.reply_status string обязательное Статус ответа
positive items.reply_status_tag_id number обязательное ID прикрепленного тега ответа
12 items.stop_sending boolean обязательное Остановлена ли отправка для этого лида
false items.stop_sending_type string обязательное Тип примененного правила остановки отправки
manual items.chosen_sender number обязательное Выбранный аккаунт отправителя ID
101 items.provider string обязательное Поставщик, используемый для отправки
gmail Недопустимое тело запроса (например, отсутствуют обязательные поля или неверные значения полей).
message string[] обязательное Список подробных сообщений о проверке или бизнес-ошибках
["Name cannot be empty", "Field must be greater than 0"] error string обязательное Краткое описание ошибки
Bad Request statusCode number обязательное HTTP код состояния ошибки
400 Этот запрос неавторизован (либо заголовок авторизации отсутствует или недействителен, либо ключ API отозван).
message string[] обязательное Список сообщений, объясняющих, почему запрос был несанкционированным
["User is not authorized", "Invalid API key"] error string обязательное Краткое описание ошибки
Unauthorized statusCode number обязательное HTTP код состояния ошибки
401 Превышен лимит запросов. Подробнее см. в документации по ограничениям запросов.
message string[] обязательное Список сообщений, объясняющих проблему ограничения скорости
["Too many requests, please try again later"] error string обязательное Краткое описание ошибки
Too Many Requests statusCode number обязательное HTTP код состояния ошибки
429