Методы API

#Адрес и авторизация

• Адрес: POST https://getsender.io/api/ext/<раздел>/<метод>, например …/api/ext/subscribers/add. Принимаются только запросы POST.
• Ключ snd_… — в заголовке Authorization: Bearer snd_… или параметром access_token в теле запроса. Не пишите ключ в адресе запроса (?access_token=): так он легче утекает.
• group_id можно не передавать: ключ уже привязан к одному каналу.
• Не больше 20 запросов в секунду на ключ.

#Формат

• Тело запроса — обычная форма (application/x-www-form-urlencoded или multipart/form-data) или JSON с заголовком Content-Type: application/json.
• Списки ID — через запятую (vk_user_id=1,2,3), массивом в JSON или повтором vk_user_id[]=…. В одном вызове — не больше 100 ID.
• vk_user_id — ID человека в этом канале: во ВКонтакте — ID страницы, в Telegram и МАКС — ID пользователя (его можно скопировать в списке подписчиков: меню строки «Ещё» → «Скопировать ID»).
• Ответ приходит в формате JSON, обычно с кодом HTTP 200 — даже при ошибке, поэтому смотрите на поле success. Успех — "success": true и данные. Ошибка — "success": false, error_code и error_message.

#Подписчики

Если у группы подписчиков настроены боты после подписки, subscribers/add их запустит — как при обычной подписке. Если кто-то из списка не разрешил сообщения, придёт ошибка 4: люди до него в списке уже будут подписаны, остальные — нет.

Условия subscribers/get (utm_id здесь и выше — номер метки, он виден в адресе страницы подписчиков с этой меткой: tag_id=3):

• vk_user_id — эти люди (так проверяют, подписан ли человек);
• subscription_id / ignore_subscription_id — подписан / не подписан на группы;
• utm_id / ignore_utm_id — есть / нет метки;
• delivery_id, ignore_delivery_id, read_delivery_id, error_delivery_id — получил рассылку, не получил, прочитал, получил с ошибкой;
• lead_status — 1 только активные, другое значение — неактивные;
• var_name и var_value — есть переменная (с этим значением);
• count — сколько вернуть, до 100; offset_id — для следующей страницы передайте offset_id из прошлого ответа.

В ответе — items: у каждого vk_user_id, subscriber_id, имя, фото, date (первое появление, ДД.ММ.ГГГГ ЧЧ:ММ:СС, время UTC), lead_status (1 — активен, 2 — нет), ignore (1 — в чёрном списке), subscriptions (действующие подписки на группы и их даты), utms (метки), utm (UTM-метки) и vars (переменные).

#Боты

Бот должен быть включён и опубликован, а человек — активен. Иначе Sender ответит {"success": true}, но бот не запустится. Того, кто уже проходит бота или прошёл его, bots/addSubscriber без enforce=1 и step_id заново не запускает.

#Переменные

Имя переменной — латинские буквы, цифры и «_», до 40 символов; заглавные буквы Sender сам делает строчными. Подробнее о переменных — Переменные.

#Справочники

Пример ответа subscribers/get:

{"success": true, "offset_id": 5012, "items": [
  {"vk_user_id": 123456, "subscriber_id": 5012, "first_name": "Анна", "last_name": "Петрова",
   "photo": "https://…", "date": "12.10.2026 09:15:00", "lead_status": 1, "ignore": 0,
   "subscriptions": [{"subscription_id": 12, "date": "12.10.2026 09:15:00", "source": "api"}],
   "utms": [{"utm_id": 3}],
   "utm": {"utm_source": "vk", "utm_medium": null, "utm_campaign": null, "utm_content": null, "utm_term": null},
   "vars": [{"n": "tariff", "v": "pro"}]}
]}

#Коды ошибок

#Частые вопросы