Developer docs

IotaBot Email API

Send from your own domain, reply in thread, and receive every email as JSON.

Get an API key

Email API error codes

Branch on error.code.

CodeStatusWhat to do
from_required400A new email needs from, one of your verified addresses.
subject_required400A new email needs a subject.
invalid_email400to is not an email address.
sender_not_found422from is not one of your email addresses this key can use (GET /email/senders).
sender_not_verified422The email domain is not verified yet, so nothing can be sent from it.
recipient_suppressed422An address bounced permanently or reported your email as spam, so nothing can be sent to it.
recipient_unsubscribed422The address unsubscribed: you can answer their emails, but not start a new thread.
no_recipient422The email conversation has no customer address to send to.
attachments_too_large400Attachments may total 10 MB per message.
api_quota_exceeded429The workspace used its monthly API messages. It resets on the 1st; the plan sets the limit.
idempotency_key_reused422The Idempotency-Key was already used with a different request.
idempotency_in_progress409A request with this Idempotency-Key is still being processed. Retry shortly.