Create an address
POST
/api/mailboxCreate a mailbox on any configured domain (quickinbox.uk). Anonymous clients receive a one-time read token and may create 20/day per IP; accounts have no daily quota and can keep 10 addresses open at once. Each mailbox has 25 MiB of storage. Deliveries that exceed the limit are rejected; saved mail is preserved.
- Authentication
- Optional for browser use; API key for scripts
- Rate limit
- 5/min + 20/day anonymous · 20/min account · 10 open addresses
Example request
curl -X POST https://quickinbox.uk/api/mailbox \
-H "Authorization: Bearer bk_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"domain":"quickinbox.uk"}'Request fields
Headers
Authorization: Bearer <api-key>
Content-Type: application/json
Body
{
"domain": "string?" // default: "quickinbox.uk"
}Response
200 OK (account)
{
"id": "string",
"email": "string",
"localPart": "string",
"domain": "string",
"createdAt": "string",
"expiresAt": null,
"closedAt": null,
"capacity": { "open": 1, "limit": 10 }
}
Anonymous mailboxes return a timed expiresAt, a one-time readToken, and daily quota details.
Account mailboxes stay open until closed.