Connect many mailboxes
Connects up to 25 mailboxes in one call, each with the same fields as a single connect. Every row gets its own result: connected, failed (with the reason) or skipped (for example past a free trial's 2 mailboxes). Rows are checked 5 at a time, so a full call can take a minute or two. Up to 500 rows an hour.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Writes | argorant:manage_lists |
Authorization
BearerAuth Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.
In: header
Header Parameters
Any unique text up to 128 characters. A retry with the same key and the same body within 24 hours returns the first answer (with the header Idempotent-Replayed: true) instead of doing the work twice. The same key with another body answers 409 idempotency_conflict.
length <= 128Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.
^[A-Za-z0-9._-]{8,64}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://app.argorant.com/api/v1/inboxes/smtp/bulk" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "mailboxes": [ { "email": "elena@northgate-advisory.com", "preset": "zoho", "smtp_password": "app-password-1" }, { "email": "mark@northgate-advisory.com", "preset": "zoho", "smtp_password": "app-password-2" } ] }'{ "connected": 1, "failed": 1, "skipped": 0, "results": [ { "row": 1, "email": "elena@northgate-advisory.com", "status": "connected", "result": "signed_in", "message": "Sign-in worked for sending and for reading replies.", "inbox": { "email": "elena@northgate-advisory.com", "provider": "smtp", "status": "connected", "daily_limit": 25 } }, { "row": 2, "email": "mark@northgate-advisory.com", "status": "failed", "result": "wrong_password", "message": "The server says the username or password is wrong. Many providers need an app password here." } ]}