API Reference
Base URL:
https://api.infrabox.softwareEvery request/response body is JSON. Endpoints that take a body are POST even when they only
read data (list/filter endpoints commonly take filters in the JSON body rather than query params —
check each page).
Authentication
API key (recommended for integrations)
Generate a key from Settings → API in the dashboard . Send it as a
Bearer token on every request:
curl https://api.infrabox.software/v1/api/account \
-H "Authorization: Bearer YOUR_API_KEY"A key authenticates as your team — it isn’t scoped to one workspace by itself.
Treat an API key like a password: don’t commit it to source control or embed it in client-side code. It can act on every workspace, domain, and mailbox on your team, plus billing.
Workspace scoping
Infrabox organizes domains, mailboxes, sequencers, and orders under workspaces (a team can have
more than one — useful for agencies running separate client environments). Most /v1/api/*
endpoints require the workspace to act on, passed as a header:
X-Workspace-Id: <workspace uid>Get a workspace’s uid from GET /v1/api/workspaces/list. A request with a missing or invalid
X-Workspace-Id on an endpoint that requires one returns 400/404 rather than silently applying
to the wrong workspace.
Identifiers
Resources are addressed by an opaque, prefixed uid rather than a database ID — for example a
mailbox is mb_..., a sequencer is seq_..., an order is a UUID. Always use the uid returned by
the API, not any internal _id field that may also appear in a response.
Where to go next
| Resource | What it’s for |
|---|---|
| Orders | Register a domain and provision its mailboxes in one call |
| Domains & DNS | Search, register, renew domains; manage DNS/DMARC/forwarding |
| Cloudflare Domains | Connect domains you already own via Cloudflare, no nameserver change |
| Mailboxes | Buy, update, and manage individual Google/Microsoft mailboxes |
| PreWarm | Buy domains/mailboxes from already-aged, pre-warmed inventory |
| Workspaces | List/create workspaces, manage members |
| Sequencers | Connect a cold-email sending tool and bulk-export mailboxes into it |
| Warmup | Turn on inbox warmup for mailboxes |
| InfraGuard | Blacklist / DNS / bounce monitoring and alerting |
| Webhooks | Get notified when a domain or mailbox changes status |
| Billing & Account | Credits, subscription, wallet |
| Tags | Organize domains and mailboxes |