Документация

Три эндпоинта и никакого аккаунта. Изучать почти нечего, поэтому и читать почти нечего.

Начните здесь

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

Все три конечные точки с параметрами, примерами и кодами состояния. Контракт полностью.

Лимит запросов, размер сообщений, срок хранения и всё остальное, что ограничено. Короткая страница, без сюрпризов.

Почтовый ящик не создаётся: Нет вызова «создать адрес». Адрес существует с момента, когда на него приходит письмо, и перестаёт существовать, когда истекает срок последнего сообщения.
Адрес и есть учётные данные: На публичном домене прочитать письма может любой, кто знает адрес — через API точно так же, как через сайт. Используйте свой домен, если это неприемлемо.
Всё имеет срок действия: Сообщения удаляются через 5 дней после получения. expires_at есть у каждого сообщения, чтобы вам не пришлось это вычислять.
Только приём: Ни одна конечная точка не отправляет почту. Это сделано намеренно: именно это не даёт бесплатному сервису без авторизации превратиться в спам-ретранслятор.

Если вызов ведёт себя иначе, чем описано в этой документации, значит баг в документации — сообщите нам, и мы это исправим.

Почта не приходит: Сначала проверьте MX-запись: только smtp.grabmail.io и ничего больше. Оставшаяся MX-запись от предыдущего провайдера незаметно забирает часть вашего трафика.
API отвечает 404: Либо домен не направлен сюда, либо у сообщения истёк срок хранения. Эти два случая различаются по слагу error.
Письмо якобы от нас: Это подделка. Отсюда ничего не может отправлять почту — наш SPF: v=spf1 -all, а наш DMARC: p=reject, что предписывает любому принимающему серверу в мире отправлять такие письма в корзину.