Актуальные обновления API и SDK. Подписка по RSS · Поддержка

October 28, 2025

Кратко

Свои домены — добавляйте и верифицируйте домены для отправки и приёма почты. Проверка через DNS (TXT, CNAME, MX), выгрузка zone-файла, настройка доставки отчётов об отскоках и жалобах. Подходит агентам, которым нужна отправка с брендового домена и контроль доставляемости.

Что нового

Новые endpoints:

  • GET /domains — список доменов
  • GET /domains/{domain_id} — детали и записи для DNS
  • POST /domains — добавить домен
  • DELETE /domains/{domain_id} — удалить домен
  • GET /domains/{domain_id}/zone-file — скачать zone-файл
  • POST /domains/{domain_id}/verify — запустить проверку DNS

Возможности:

  • Верификация через TXT, CNAME, MX
  • Статусы: NOT_STARTED, PENDING, VERIFYING, VERIFIED, FAILED, INVALID
  • Статус по каждой записи (MISSING, INVALID, VALID)
  • Экспорт zone-файла для провайдера DNS
  • Опционально — доставка bounce/complaint по домену

Сценарии

Собирайте системы, где:

  • агенты отправляют с верифицированного домена
  • DNS настраивается централизованно, zone-файл импортируется у регистратора
  • онбординг или мониторинг завязаны на статус верификации
  • отскоки и жалобы настраиваются отдельно по доменам
1from agentinbox import Agentinbox
2
3client = Agentinbox(api_key="your-api-key")
4
5# create a domain
6domain = client.domains.create(
7 domain="mail.example.com",
8 feedback_enabled=True
9)
10
11# get verification records and status
12domain = client.domains.get(domain_id=domain.domain_id)
13for record in domain.records:
14 print(f"{record.type} {record.name}: {record.status}")
15
16# trigger verification after updating DNS
17client.domains.verify(domain_id=domain.domain_id)

Подробнее — в руководствах Свои домены и Управление доменами.