Update a mailbox
Changes a mailbox's sender name, its daily sending limit, or turns it off and on. Only what you send changes. Server settings, logins and passwords can't be changed through the API: reconnect the mailbox in Alienmail.
Requires the SMTP_UPDATE permission.
apiKeyAuthorizationBearer <token>An API key of your workspace, from Workspace settings, Integrations. Each key has a role, and the role decides which endpoints it may call.
id*integerThe mailbox id, from the mailbox list.
application/json- body
name?stringThe sender name recipients see.
1 <= length <= 191dailyLimit?integerMost emails this mailbox sends per day, 1 to 2000.
1 <= value <= 2000active?booleanfalse stops sending from this mailbox; true turns it back on.
The updated mailbox.
application/json- response
id*integerThe mailbox id.
email*stringThe address it sends from.
name*stringThe sender name recipients see.
provider*stringHow the mailbox is connected.
"smtp""google""microsoft""outlook"active*booleanWhether campaigns may send from it.
connected*booleanfalse when the last connection check failed. Reconnect it in Alienmail.
rateLimited*booleanThe mail provider is throttling this mailbox.
dailyLimit*integerMost emails it sends per day, 1 to 2000.
sentToday*integerEmails counted against the daily limit so far.
createdAt*stringdate-timeupdatedAt*stringdate-timecurl -X PATCH 'https://app.alienmail.io/api/v1/mailboxes/7' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": 7, "email": "ada@analyticalengines.com", "name": "Ada from Analytical Engines", "provider": "google", "active": true, "connected": true, "rateLimited": false, "dailyLimit": 50, "sentToday": 12, "createdAt": "2026-11-13T09:30:00.000Z", "updatedAt": "2026-11-13T09:30:00.000Z"}