Skip to main content

Update account settings

PUT 
/api/accounts/:accountId/settings

Saves per-account settings, such as the sending identities, and returns all settings stored for the account.

Each top-level property of the body is stored under its own key, overwriting it; keys not in the body are kept. identities must be an array and is normalized before saving: addresses are lowercased and deduplicated, the account address and its aliases are always added back, other addresses are marked custom, and exactly one identity is isDefault (the primary address when none is chosen), which is always enabled. Keys are saved one by one, so keys that come before an invalid identities are still stored.

Needs a session, but not mailbox access.

Request​

Responses​

All stored account settings after the update.