Getting Started

Create an account

Sign up at the Infrabox dashboard . Signing up creates your team and a default workspace — the container Infrabox uses to scope domains, mailboxes, and API access. You can create more than one workspace (for example, one per client if you run an agency) and switch between them from the dashboard.

Generate an API key

From Settings → API, generate a key. It authenticates as your team, not a single workspace — which workspace a request applies to is chosen per-request (see below), so one key can drive every workspace on your team.

Make your first request

Every request is authenticated with a Bearer token:

curl https://api.infrabox.software/v1/api/account \
  -H "Authorization: Bearer YOUR_API_KEY"

Most operations — buying mailboxes, listing domains, connecting sequencers — act on a specific workspace, selected with the X-Workspace-Id header:

curl -X POST https://api.infrabox.software/v1/api/mailboxes/list \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{}'

Get a workspace’s uid from GET /v1/api/workspaces/list, or from the workspace switcher URL in the dashboard. See Overview & Authentication for the full auth model.

Provision something

The fastest path to a working mailbox is a single Order — it registers the domain(s) and creates the mailboxes on it in one call:

curl -X POST https://api.infrabox.software/v1/api/orders \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": [{
      "name": "yourdomain.com",
      "redirect_url": "https://yourcompany.com",
      "mailboxes": [
        { "first_name": "John", "last_name": "Doe", "email": "[email protected]" }
      ]
    }]
  }'

Poll GET /v1/api/orders/{order_id} (or watch the dashboard) until every domain and mailbox reports completed — registration, DNS/DMARC setup, and mailbox creation all happen asynchronously in the background.

Connect mailboxes to your sequencer

Once mailboxes exist, bulk-import them into your cold-email sending tool with one call instead of copying credentials by hand:

curl -X POST https://api.infrabox.software/v1/api/sequencers/export \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UID" \
  -H "Content-Type: application/json" \
  -d '{
    "sequencer_uids": ["seq_..."],
    "mailbox_uids": ["mb_...", "mb_..."]
  }'

See Sequencers for adding a sequencer connection first, supported platforms, and export-status polling.