DEVELOPER DOCUMENTATION
Your inboxes, programmable.
Create an API key in your console. Authenticate every request with a Bearer token.
Quick start
curl https://api.inbox.cheap/v1/mailboxes \ -H "Authorization: Bearer YOUR_API_KEY"
| Method | Endpoint | Action |
|---|---|---|
| GET / POST | /v1/mailboxes | List or create addresses |
| DELETE | /v1/mailboxes/{id} | Permanently retire an address |
| GET | /v1/mailboxes/{id}/messages | List received messages |
| GET | /v1/messages/{id}/raw | Download original email |
| GET | /v1/domains | List available domains |
Create an inbox
{"localPart":"project-tests","domain":"159.hk"}Prefixes require 6–63 characters. Destroyed addresses cannot be reused. Free and Plus use 159.hk; Pro also unlocks inbox.cheap.