---
title: Как создать API-ключ
description: Получение API-ключа для интеграции с Multi API — через раздел API Подключения
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

# Как создать API-ключ

> **Коротко:** API-ключ — ваш пропуск для интеграции с Multi API. Создаётся в личном кабинете за 1 минуту.

## Кому подходит

- Роль: Разработчик, Клиент
- Уровень: Новичок

## Что вы получите

API-ключ для отправки запросов в Multi API.

## Перед началом

- [ ] У вас есть доступ к личному кабинету Multi API.
- [ ] Вы знаете, какие права нужны для вашей интеграции.

## Шаги

### Шаг 1. Откройте раздел «API Подключения»

В левом меню: **API Подключения**.

### Шаг 2. Нажмите «Создать API подключение»

Кнопка в правом верхнем углу.

### Шаг 3. Заполните форму

| Поле | Что указать |
|---|---|
| **Название** | Понятное имя, например «Тестовый ключ» |
| **Вебхук** | URL, куда будут отправляться статусы (необязательно) |
| **Права доступа** | Выберите нужные права |

### Шаг 4. Выберите права доступа

| Право | Для чего |
|---|---|
| omni-api | Отправка сообщений, проверка статусов |
| statistics | Доступ к статистике и EDR |
| recipients | Управление получателями |
| broadcasts | Управление рассылками |
| dids | Управление DID-номерами |
| crm | Интеграция с CRM |

### Шаг 5. Выберите имена отправителей

Укажите, для каких имён отправителей будет действовать этот ключ.

### Шаг 6. Нажмите «Получить API ключ»

### Шаг 7. Скопируйте ключ

> **Важно:** ключ показывается только один раз. Сохраните его в надёжном месте.

## Как использовать

Ключ передаётся в заголовке X-API-Key в каждом запросе.

Формат заголовка:
X-API-Key: ваш-ключ

## Результат

API-ключ создан. Вы можете использовать его для интеграции с Multi API.

## Управление ключом

| Действие | Что делает |
|---|---|
| **Просмотр** | Показывает название, права, вебхук |
| **Редактирование** | Изменяет права, вебхук, имена отправителей |
| **Удаление** | Отзывает ключ — все запросы с ним перестанут работать |

> **Совет:** создавайте отдельный ключ для каждого окружения (тест, продакшн) и для каждого приложения.

## Частые проблемы

| Симптом | Причина | Решение |
|---|---|---|
| Ключ не показывается | Уже создан, но потерян | Создайте новый, удалите старый |
| 401 Unauthorized | Неверный ключ | Проверьте X-API-Key |
| 403 Forbidden | Нет нужного права | Отредактируйте ключ, добавьте право |
| Вебхук не работает | Неверный URL | Проверьте доступность URL |

## См. также

- [Базовый URL и аутентификация](/03-multiapi/01-for-developers/mapi-303-base-url)
- [Отправьте первое сообщение через API](/03-multiapi/01-for-developers/mapi-007-first-message)
- [Обработка ошибок API](/06-reference/03-troubleshooting/ts-api-http-codes)

## Нужна помощь?

- **Multi API:** support@multiapi.ru