# API VK Рекламы: POST /api/v2/ad_groups.json — Создание группы объявлений

Ответ: `id` и `banners` (если объявления переданы).

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `name` | body | string | нет | Название группы |
| `status` | body | string | нет | По умолчанию active |
| `date_start` | body | string | нет | Дата начала |
| `date_end` | body | string | нет | Дата окончания |
| `budget_limit_day` | body | string | нет | Дневной бюджет |
| `budget_limit` | body | string | нет | Общий бюджет (кратно budget_limit_step) |
| `package_id` | body | integer | нет | Пакет (формат размещения) |
| `banners` | body | array | нет | Объявления: content, urls, textblocks |
| `targetings` | body | object | нет | Таргетинги: пол, возраст, гео, интересы, pads |

## Базовые URL

- Боевой: `https://ads.vk.ru`
- Методы: `/api/v2/`

## Авторизация

Тип: OAuth 2.0

Токен получают методом `POST /api/v2/oauth2/token.json` (`application/x-www-form-urlencoded`) и передают в заголовке:

Токен живёт сутки (`expires_in` = 86400) и продлевается через `refresh_token`. На пару «client_id + пользователь» — не больше 5 токенов одновременно; запрос сверх лимита возвращает HTTP 403.

```
Authorization: Bearer {access_token}
```

## Нюансы

- Фильтры в списках задаются префиксом `_` и суффиксами `__in`, `__ne`, `__lt`, `__lte`, `__gt`, `__gte`.
- `ad_groups` нельзя запрашивать через `fields` в списке кампаний.
- Посуточная статистика доступна не больше чем за последние 365 дней.
- Временные токены удаляются автоматически после месяца без использования.
- Есть отдельные эндпоинты статистики по целям (`/api/v2/statistics/goals/...`), in-app событиям (`/api/v2/statistics/inapp/...`) и офлайн-конверсиям.
- Для агентств и менеджеров — ресурсы AgencyClients и ManagerClients и токен с `grant_type=agency_client_credentials`.

## Сценарии с этим методом

- [Создать кампанию с группой объявлений](https://mcp-everything.ru/integrations/vk-ads/scenarios/sozdat-kampaniyu-s-gruppoy-obyavleniy.md)

---

Если этого недостаточно — официальная документация: https://ads.vk.ru/en/doc/api/info/Authorization
Вся интеграция одним документом: https://mcp-everything.ru/integrations/vk-ads.md