Ограниченное время: скидка 30% на первый платёж.
Публичный REST API

У InboxWarm есть публичный API для прогрева почты

Автоматизируйте прогрев, получайте данные о доставляемости и управляйте каждым почтовым ящиком программно — 27 REST-эндпоинтов, включены в каждый тариф.

Последнее обновление:

Кратко

У InboxWarm есть публичный REST API с 27 эндпоинтами в 5 категориях — Почтовые аккаунты, Прогрев, Доставляемость, Отчёты и Система. Он позволяет подключать почтовые ящики, запускать и останавливать прогрев, а также получать оценки доставляемости и отчёты в собственных инструментах. Доступ включён в каждый тариф без дополнительной платы: зарегистрируйтесь, сгенерируйте API key в разделе Developer Kit > API Integration и сделайте первый запрос менее чем за 5 минут.

Зачем нужен API

Зачем использовать API InboxWarm?

API InboxWarm создан для того, чтобы вы могли запускать прогрев почты и мониторинг доставляемости из собственного продукта, скриптов и дашбордов, а не из веб-приложения InboxWarm.

Автоматизируйте запуск и остановку прогрева

Запускайте прогрев в момент подключения нового почтового ящика и приостанавливайте его при запуске кампании — не заходя в дашборд.

Получайте данные о доставляемости в собственных дашбордах

Передавайте оценки настройки, состояние DNS, попадание во «Входящие» и ежедневные отчёты о прогреве напрямую в свой BI-инструмент или внутреннюю админку.

Подключите InboxWarm к своему продукту или внутренним инструментам

Управляйте почтовыми ящиками программно из своего онбординга, CRM или бэк-офиса агентства с помощью простых REST-запросов.

Включено в каждый тариф, без дополнительной платы

Каждый тариф InboxWarm включает полный доступ к API без дополнительной платы — сгенерируйте API key и начните вызывать эндпоинты уже сегодня.

Возможности

Что можно делать с помощью API InboxWarm?

API для прогрева почты охватывает 27 REST-эндпоинтов в 5 категориях; полное описание каждого эндпоинта доступно в публичном справочнике API.

8 эндпоинтов

Почтовые аккаунты

Подключайте почтовые ящики Gmail, Microsoft или SMTP/IMAP, проверяйте их состояние подключения и управляйте ими по отдельности или массово.

9 эндпоинтов

Прогрев

Запускайте, останавливайте и настраивайте прогрев почты для любого ящика — включая массовые действия сразу для 50 ящиков за один запрос.

4 эндпоинтов

Доставляемость

Проверяйте оценку настройки, запускайте DNS-проверки в реальном времени (SPF, DKIM, DMARC, MX) и измеряйте попадание во «Входящие» против спама для каждого провайдера.

4 эндпоинтов

Отчёты

Получайте ежедневные отчёты о прогреве, сводки по всем аккаунтам и асинхронные CSV-экспорты в собственные дашборды и инструменты.

2 эндпоинтов

Система

Эндпоинты проверки работоспособности и статуса лимита запросов — отслеживайте свою интеграцию, не расходуя квоту запросов.

Полный справочник

Примеры запросов и ответов для каждого эндпоинта, коды ошибок и детали аутентификации.

Открыть справочник API
Быстрый старт

Как начать работу с API InboxWarm?

Вы можете сделать первый запрос к API InboxWarm менее чем за 5 минут: зарегистрируйтесь, сгенерируйте API key и отправьте один curl-запрос — без плясок с OAuth и установки SDK.

  1. 1

    Создайте аккаунт InboxWarm — 10-дневный бесплатный пробный период не требует банковской карты.

  2. 2

    Сгенерируйте API key в разделе Developer Kit > API Integration в приложении.

  3. 3

    Вызовите любой эндпоинт — например, получите список подключённых почтовых аккаунтов:

GET /email-accounts
curl "https://app.inboxwarm.ai/api/v1/email-accounts?api_key=YOUR_API_KEY"

Вот и всё — в ответе вы получите JSON-список ваших почтовых ящиков с их статусом прогрева. Дальше можно запустить прогрев одним POST-запросом.

Аутентификация

Как аутентифицироваться в API InboxWarm?

Каждый запрос аутентифицируется с помощью вашего API key; место, куда его нужно поместить, зависит от используемого HTTP-метода.

GET / DELETE

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

Добавьте ваш API key в URL как параметр запроса api_key.

?api_key=YOUR_API_KEY
POST

Поле в теле JSON

Укажите ваш API key как поле apiKey внутри тела JSON-запроса.

{ "apiKey": "YOUR_API_KEY", ... }

Создавайте и управляйте API keys в разделе Developer Kit > API Integration в приложении InboxWarm. Каждый key предоставляет полный доступ к аккаунту для всех эндпоинтов.

Сценарии использования

Что можно построить с помощью API InboxWarm?

Команды используют API доставляемости InboxWarm, чтобы встроить прогрев и мониторинг почтовых ящиков в свои продукты, BI-пайплайны и рабочие процессы агентств — вот три распространённых сценария.

1

Запускайте прогрев из своего онбординга

Когда ваш продукт создаёт новый отправляющий почтовый ящик для клиента, вызовите POST /email-accounts, чтобы подключить его, и POST /warmup-settings/{id}/start, чтобы автоматически запустить прогрев — ящик начинает прогреваться ещё до того, как клиент завершит онбординг.

2

Получайте еженедельные оценки доставляемости в свой BI-инструмент

Настройте еженедельную задачу, которая вызывает POST /deliverability-score/{id} и POST /reports/bulk, а затем передавайте показатели «Входящие» против спама в Looker, Metabase или Google Sheets, чтобы вся команда видела тренды доставляемости рядом с метриками кампаний.

3

Отслеживайте почтовые ящики клиентов из дашборда агентства

Агентства, управляющие десятками почтовых ящиков клиентов, используют POST /email-accounts/bulk-status и GET /dashboard, чтобы видеть ошибки аутентификации, оценки состояния и статусы прогрева в одном внутреннем окне — а POST /warmup-settings/bulk-action помогает массово устранять проблемы.

Лимиты запросов и цены

Какие лимиты запросов и сколько стоит API?

Лимит по умолчанию — 20 запросов в минуту на каждый API key, а доступ к API включён в каждый тариф InboxWarm без дополнительной платы.

20 req/min

Лимит по умолчанию на каждый API key. Проверяйте текущее использование в любой момент через GET /rate-limit — этот запрос не расходует вашу квоту.

$0 дополнительно

Доступ к API включён в каждый тариф — нет отдельного уровня для API, платы за использование или платного дополнения. См. цены.

Часто задаваемые вопросы

Часто задаваемые вопросы

Да. У InboxWarm есть публичный REST API с 27 эндпоинтами в 5 категориях: Почтовые аккаунты, Прогрев, Доставляемость, Отчёты и Система. Он доступен каждому клиенту на любом тарифе без дополнительной платы.

Зарегистрируйтесь в InboxWarm (10-дневный бесплатный пробный период, банковская карта не требуется), затем откройте Developer Kit > API Integration в приложении, чтобы создавать API keys и управлять ими. Каждый key предоставляет полный доступ к аккаунту для всех эндпоинтов.

Вы можете подключать почтовые аккаунты и управлять ими, запускать и останавливать прогрев, читать настройки прогрева, проверять оценки настройки и доставляемости, запускать DNS-проверки, а также получать ежедневные отчёты о прогреве и сводки дашборда в собственных инструментах.

InboxWarm использует смешанную схему аутентификации в зависимости от HTTP-метода: запросы GET и DELETE передают ваш API key как параметр запроса api_key, а запросы POST — как поле apiKey внутри тела JSON. Поток OAuth не требуется.

Лимит по умолчанию — 20 запросов в минуту на каждый API key. Проверить текущее использование можно в любой момент с помощью GET /rate-limit — этот запрос не расходует вашу квоту.

Доступ к API включён в каждый тариф InboxWarm без дополнительной платы. Отдельного уровня для API, платы за использование или платного дополнения не существует.

Да. InboxWarm предоставляет коллекцию Postman с mock-сервером, чтобы вы могли изучить и протестировать каждый эндпоинт ещё до написания кода. Она находится рядом с вашими API keys в Developer Kit > API Integration в приложении.

Полное описание всех 27 эндпоинтов доступно публично по адресу https://inboxwarm.ai/api/docs/ — вход в систему не требуется.

Да. Используйте POST /warmup-settings/{emailAccountId}/start и POST /warmup-settings/{emailAccountId}/stop, чтобы управлять прогревом одного почтового ящика, или POST /warmup-settings/bulk-action, чтобы запускать или останавливать прогрев сразу для 50 ящиков за один запрос.

Да. API включает массовые эндпоинты для подключения учётных записей (до 20 почтовых ящиков), запуска/остановки прогрева (до 50 ящиков), статуса аккаунтов (до 50 ящиков), удаления аккаунтов (до 20 ящиков) и ежедневных отчётов (до 50 ящиков за один запрос).

Готовы автоматизировать прогрев почты?

Получите API key за несколько минут — 27 эндпоинтов, 10-дневный бесплатный пробный период, без банковской карты, доступ к API включён в каждый тариф.