Receive email
Provision inboxes and fetch incoming messages.
Provisioning
POST /inboxes returns 202. Poll the list until active. All plans have unlimited inboxes; volume, storage and retention still apply.
Custom addresses
POST /inboxes/{id}/receiving-address assigns or renames an address. Verify its domain and MX first. A routing 503 can mean a pending durable change; inspect receiving_status before retrying. DELETE removes the custom route.
Pagination and IDs
List responses contain uid_validity, messages and next_before. Pass next_before as before; limit defaults to 20, maximum 50. IDs here are mailbox UIDs, not outbound UUIDs. Persist inbox ID, UID validity and UID together.
Events and raw messages
email.received contains message identifiers, not the body. Fetch details separately. /messages/{uid}/raw downloads an application/octet-stream .eml. New webhook endpoints do not replay historical incoming mail. Read messages before retention expires.