Connect a mailbox from any provider
Connects one mailbox from any email provider with its server settings. Argorant first signs in to send and to read replies and connects the mailbox only when both work; otherwise the answer is sign_in_failed with the test result. The password is stored encrypted and never returned. Connecting the same address again replaces its settings, which is how a mailbox is reconnected after a password change. A free trial connects up to 2 mailboxes. Up to 30 connects an hour; use the bulk route for more.
| 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" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "email": "elena@northgate-advisory.com", "display_name": "Elena Vaughn", "preset": "zoho", "smtp_password": "app-password", "daily_limit": 30 }'{ "inbox": { "email": "elena@northgate-advisory.com", "name": "Elena Vaughn", "provider": "smtp", "status": "connected", "health": "healthy", "daily_limit": 30, "active": true }, "test": { "works": true, "message": "Sign-in worked for sending and for reading replies.", "smtp": { "works": true, "result": "signed_in", "message": "Sending works." }, "imap": { "works": true, "result": "signed_in", "message": "Reading replies works." } }}