• BotHunter
  • Регистрация в сервисе
  • Быстрый старт
  • Руководители, Сообщества, Тарифы
  • Мессенджеры и соц. сети
    • ВКонтакте
      • Как подключить сообщество ВК к системе
        • Возможные ошибки
      • Форматирование текста ВКонтакте
      • Виджеты
      • Вложения
      • Как добавить ключи сообщества
    • Telegram
      • Вложения
      • Начало работы
        • Как подключить бота к системе
        • Как создать бота для Telegram
      • Особые возможности
        • Чат-бот для личных сообщений
        • Загрузка больших вложений
        • Меню для чат-ботов в Telegram
        • Настройка информации о боте в Telegram
        • Отправка стикеров и эмоджи
        • Работа чат-ботов в каналах
        • Условия проверки в Telegram
        • Запуск бота по ссылке
      • Лимиты Telegram
    • MAX
      • Как создать бота в MAX
      • Как сделать простого чат-бота?
      • Запуск бота по ссылке
      • Активности для ботов Max
      • Работа чат-ботов в каналах
      • Загрузка больших вложений
    • Одноклассники
      • Как подключить сообщество к системе
      • Как создать бота для Одноклассников
    • Авито
      • Как подключить Авито
      • Как сделать простого чат-бота
  • Автоматизация
    • Чат-боты
      • Как сделать простого чат-бота?
      • Основные принципы работы ботов
        • Как создаются боты?
        • Ответы на частые вопросы
        • Принцип работы цепочек
      • Конструктор
        • Навигация и интерфейс
          • Масштабирование
          • Поиск пользователя в боте
          • Поиск шага
          • Ошибки в чат-ботах
          • Формы стрелок
          • Соединение блоков
          • Центрирование рабочей области
          • Поиск связанных блоков
          • Группировка блоков
          • История шагов в боте
        • Блоки
          • Условие
            • Текст
            • Время
            • Переменные
            • Боты
            • Списки
            • Пользователь
            • Публикации
            • Магазин
            • Дополнительно
            • Чат/канал
            • Регулярные выражения
            • Поиск телефона в сообщении
          • Действие
            • Переменные
              • Переменные пользователя
              • Переменные сообщества
            • Боты
              • Действия с ботами
            • Списки
              • Списки пользователей
              • Облачные списки (VK)
              • Черный список сервиса (VK)
            • Страницы
              • Мини-лендинги
            • Пользователи
              • Профиль пользователя
            • Интеграции
              • Действия с платежными системами
              • Действия с интеграциями
            • Дата и время
            • Сообщения
            • Беседы (VK)
              • Управление участниками беседы
            • Чаты (TG)
              • Действия с темами в чате
              • Действия с чатами
            • Текст
              • Парсер текста
            • Сообщество (VK)
              • Публикации
              • Комментарии
              • Аудиозаписи
            • Аналитика
              • Воронки
            • Дополнительно
              • Функции
                • Калькулятор
                • Получить часть строки (текста)
                • Привести текст к нижнему/верхнему регистру
                • Найти и заменить
                • Разбить текст на части
                • Получение уникального идентификатора
              • Запрос во вне
          • Сообщение
            • Редактирование сообщения
            • Особенности Telegram
            • Форматирование текста Telegram
            • Отправка стикера в VK
            • Как отправлять пост вложением
            • Отправка сообщений другому человеку, в тему чата или от другого сообщества
            • Ожидающие действия
            • Клавиатура (кнопки)
            • Как отправить премиум эмодзи в Telegram
          • Таймер
          • AI-блок
      • Аналитика
        • Ошибки в чат-ботах
        • Уведомления об ошибках
      • Активности
        • Активности ботов для ВКонтакте
        • Активности ботов для Telegram
        • Активности ботов для Одноклассников
        • Запустили другим ботом или внешним источником
      • Расширенные настройки бота
      • Как поделиться чат-ботом
    • Примеры чат-ботов
      • Ответ на "Привет"
      • Сбор телефона и email
      • Сертификаты/именные изображения
        • Изображение с добавлением персонализированного текста
        • Изображение с персонализированным фото
      • Борьба с "умными" спамерами в беседе VK
      • Модератор чата/беседы (карма-бот)
      • Аукцион
      • Оповещение о комментариях с вопросом
      • Печенька с предсказаниями
      • ChatGPT Шаблон для изображений
    • Переменные
      • Стандартные переменные
        • Переменные дат
      • Переменные пользователя
      • Переменные сообщества
      • Дополнительно
        • Сложные переменные
    • Интеграции
      • TH таблицы
        • Возможности и принцип работы
      • Платежные системы
        • Как выдавать ссылки на оплату и отслеживать сами оплаты в боте?
        • Продамус
          • Рекуррентные платежи
        • Т-банк
        • ЮKassa
          • Рекуррентные платежи
        • ЮMoney
        • CloudPayments
        • Robokassa
        • Telegram Payments
      • Google Таблицы
        • Подключение
        • Возможности и принцип работы
      • Нейросети
        • ChatGPT
        • Gemini
        • DeepSeek
        • Claude
        • Grok
        • YandexGPT
      • SMSC
      • GetCourse
      • Автопилот
      • Бизон365
      • Albato
        • Связка с amoCRM
        • Связка с Google Meet
      • amoCRM
      • DashaMail
      • Voice Password
    • Аналитика в BotHunter
    • UTM-метки
  • Пользователи
    • Действия с пользователями и фильтры
    • Возможности для ВКонтакте
    • Списки пользователей
    • Как перенести подписчиков из других сервисов?
      • Senler
      • BotHelp
      • SaleBot
      • SendPulse
  • Рассылки
    • Рассылка
  • Страницы
    • Приложение VK
      • О приложении
      • Подключение и настройки видимости
    • Мини-Лендинги
      • Создание мини-лендинга
      • Мультиканальные мини-лендинги
      • Сбор номера телефона и Email
      • Частые вопросы
    • Аналитика
      • Отслеживание действий пользователя VK
      • VK Пиксель
      • Яндекс.Метрика
  • Полезные материалы
    • Как узнать свой ID в мессенджере/соц. сети
    • Глобальные обновления
      • Система папок
      • Глобальное обновление 18.12.2022
      • Глобальное обновление 07.02.2022
    • Как перейти на новую версию
  • Разработчикам
    • API
      • Константы
      • API Ключ
      • Методы
        • Аккаунт
          • Проверить токен
        • Сообщества
          • Получить список сообществ
          • Получить сотрудников сообщества
        • Боты
          • Получить список ботов
          • Получить бота по ID
          • Получить шаги бота
          • Включить бота
          • Выключить бота
          • Добавить пользователя в бота
          • Удалить пользователя из бота
        • Рассылки
          • Получить список рассылок
          • Получить рассылку по ID
          • Получить вложение рассылки
        • Списки
          • Получить списки сообщества
          • Создать список
          • Переименовать список
          • Получить подписчиков списка
          • Добавить подписчика в список
          • Убрать подписчика из списка
        • Контакты
          • Получить карточку подписчика
          • Получить переменные подписчика
          • Получить списки подписчика
          • Получить ботов подписчика
        • Пользовательские переменные
          • Получить список пользовательских переменных
          • Создать пользовательскую переменную
          • Получить
          • Установить
          • Очистить
        • Переменные сообщества
          • Получить список переменных сообщества
          • Создать переменную сообщества
          • Получить
          • Установить
          • Очистить
        • Лендинги
          • Получить список лендингов
        • Воронки
          • Получить список воронок
          • Получить воронку со статистикой
        • Статистика
          • Получить статистику рассылок
          • Получить статистику одной рассылки
          • Получить статистику лендингов
          • Получить статистику одного лендинга
          • Получить подписки с рекламы по UTM-меткам
      • Прежнее описание API (устарело)
    • Вебхуки
  1. API
  2. >
  3. Методы
  4. >
  5. Списки

Создать список

https://bot-api.targethunter.ru/external-api/v2/lists/create

Создаёт в сообществе новый обычный список подписчиков — как кнопка «Создать список» в интерфейсе.

Нужен личный токен с продуктом BotHunter — как получить. Кому доступен: владельцу сообщества и сотрудникам с ролью «Админ (полный доступ)» или «Пользователи».

Лимит: не больше 20 созданий в минуту и 200 в сутки — вместе с vars/create и globalVars/create. Считается и попытка с ошибкой в параметрах, сутки начинаются в 03:00 по Москве. Сверх лимита — ошибка 5, ничего не создаётся.

Параметры

group_id
целое число
обязательный

Номер сообщества — group_id из ответа groups/get.

Пример: 123456

channel
строка
обязательный

Канал сообщества: VK, TG, OK, MAX, CHAT или AVITO — константы.

Пример: VK

name
строка
обязательный

Название списка, до 120 символов. Названия могут повторяться, как и в интерфейсе.

Пример: Клиенты

Результат

Возвращает созданный список — как элемент lists/get. Его id передавайте как list_id в остальные методы lists/*.

{
  "status": "ok",
  "response": {
    "id": "65a6e5f4c0e8f20012d3a111",
    "name": "Клиенты",
    "count_users": 0
  }
}

Коды ошибок

Общие ошибки — на странице API.

Код

Когда

5

«Слишком много созданий: не больше 20 в минуту и 200 в сутки. Повторите позже.»: лимит созданий исчерпан, ничего не создано.

7

Не передан group_id или channel, значение неверное или такого сообщества нет.

«Не указан обязательный параметр name»: name не передан или пустой.

«Поле "Название" должно принимать значение менее чем 120 символов.»: название длиннее 120 символов.

Пример запроса

Подставьте свой токен вместо <ваш_токен>.

curl
PHP
Python
JavaScript
curl -X POST https://bot-api.targethunter.ru/external-api/v2/lists/create \
  -H "Authorization: Bearer <ваш_токен>" \
  -H "Content-Type: application/json" \
  -d '{"group_id": 123456, "channel": "VK", "name": "Клиенты"}'
$token = '<ваш_токен>';
$url = 'https://bot-api.targethunter.ru/external-api/v2/lists/create';
$params = [
    'group_id' => 123456,
    'channel' => 'VK',
    'name' => 'Клиенты',
];

$curl = curl_init($url);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . $token,
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($params),
]);

$response = json_decode(curl_exec($curl), true);
curl_close($curl);
import requests

token = '<ваш_токен>'
url = 'https://bot-api.targethunter.ru/external-api/v2/lists/create'
params = {
    'group_id': 123456,
    'channel': 'VK',
    'name': 'Клиенты',
}

response = requests.post(url, json=params, headers={'Authorization': f'Bearer {token}'})
print(response.json())
const token = '<ваш_токен>';
const params = {
  "group_id": 123456,
  "channel": "VK",
  "name": "Клиенты"
};

const response = await fetch('https://bot-api.targethunter.ru/external-api/v2/lists/create', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(params),
});
console.log(await response.json());