Change many mailboxes
The same change for many mailboxes in one call: daily limit, warm-up (on or off, or a number a day), switched on or off, or time zone. Choose them by address, domain, tag or status, or all_connected; for every mailbox send status: ["any"]. The default is a preview that counts what would change and changes nothing. Send preview: false to apply. Switching off more than one mailbox also needs confirmed: true, because people queued on them wait for another mailbox.
| 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
application/json
curl -X POST "https://app.argorant.com/api/v1/inboxes/update" \ -H "Idempotency-Key: 6f1c2e7a-run-42" \ -H "Content-Type: application/json" \ -d '{ "domains": [ "northgate-advisory.com" ], "settings": { "daily_limit": 30 }, "preview": true }'{ "matched": 12, "would_change": 10, "already_set": 2, "preview": true, "summary_text": "10 of 12 mailbox(es) would change, 2 already have these settings. Nothing changed yet."}