Подписчики
Управление списком подписчиков и их тегами.
GET /v1/subscribers
Список подписчиков проекта. Пагинация через query-параметры.
limit number Кол-во записей (по умолчанию 50, макс. 200)
offset number Смещение от начала списка (по умолчанию 0)
channel string Фильтр по каналу: telegram или max
Ответ
{
"subscribers": [
{
"id": "550e8400-...",
"channel": "telegram",
"first_name": "John",
"username": "johndoe",
"lang": "ru",
"tags": ["vip"],
"created_at": "2026-03-05T12:00:00Z"
}
],
"total": 150
}
PUT /v1/subscribers/:id/tags
Обновление тегов подписчика. Передайте полный массив тегов. Теги должны быть предварительно созданы в настройках проекта или через API. Несуществующие теги будут автоматически созданы (если не достигнут лимит 20).
PUT /v1/subscribers/sub_abc/tags
{
"tags": ["vip", "beta"]
}
Ответ
{
"updated": true
}