Provision mailboxes with a single API call.
A full REST API and a production MCP server to build Icemail into your stack — or hand the entire provisioning pipeline to an AI agent.
curl -X POST https://api.icemail.ai/v1/mailboxes \
-H "Authorization: Bearer $ICEMAIL_KEY" \
-H "Content-Type: application/json" \
-d '{
"provider": "google",
"domain": "reach-icemail.io",
"count": 50,
"warmup": "pre-warmed"
}'
# 200 OK
{
"job_id": "job_8sR2",
"status": "provisioning",
"mailboxes": 50,
"eta_seconds": 480
}REST API
v1 · stable · 100% coverage
Every dashboard action — mailbox provisioning, domain purchase, exports, webhooks — exposed as a clean, predictable REST endpoint. SDKs for Node, Python, Go and Ruby.
- Bearer-token auth with scoped keys
- Idempotency keys on every write
- Webhooks for async jobs & replies
- JSON-only, RFC-compliant errors
MCP Server
model context protocol · production
Drop Icemail into Claude, Cursor, GPT, or your custom agent. Tools like create_mailboxes, export_to_sequencer, and warm_domain are callable in natural language.
Endpoint reference
Everything you'd click — now callable.
The same primitives that power the Icemail app, exposed as a small, focused REST surface.
/v1/mailboxesCreate N mailboxes on Google or Microsoft.
/v1/mailboxes/:idRetrieve mailbox status & credentials.
/v1/domainsPurchase or attach a domain.
/v1/exportsPush mailboxes to Instantly / Smartlead / Bison.
/v1/inbox/threadsQuery unified-inbox threads & replies.
/v1/webhooksSubscribe to provisioning + reply events.
Scoped API keys
Create read-only, provisioning, or admin keys. Rotate without downtime.
SOC-2 aligned infra
TLS everywhere, encrypted secrets at rest, audit log on every key action.
Sane rate limits
600 req/min default. Bulk endpoints auto-batch. Need more? Just ask.
What teams build on it
Spin up a full sending stack the moment a contract is signed.
White-label provisioning inside your platform via API + webhooks.
Let an LLM provision, configure DNS, warm, and export — end to end.
Thousands of mailboxes per job, with webhook callbacks when ready.