Email sending and mailboxes
Connect a Gmail account or claim a hosted address on @xuda.app, and send through the same path either way.
Every mailbox in Xuda is one of two vendors: a Gmail account you connect, or a hosted address on
@xuda.app that Xuda provisions for you. Both count against the same plan allowance, both sit
behind the same identity check, and mail sent from either goes out through the same submission
path.
Connect Gmail
Sign in with Google
You authorize read access to the mailbox (Gmail's own gmail.readonly scope) and Xuda exchanges
the code it gets back for an access token and a refresh token.
Xuda checks the exchange actually succeeded
Google can answer with an HTTP 200 that carries an error in the body instead of a token, so that body is read and rejected explicitly rather than trusted because the request itself succeeded.
The mailbox is filed under your account
On a brand-new connection (not a reconnect of one already here), it needs the workspace's Emails plan and requires your account to already be at the identity verification level a mailbox needs. It takes none of the plan's seats: the plan counts Xuda mailboxes only, so a Gmail or Outlook can be connected on any plan, as many as you like.
Google only guarantees a refresh token on the very first consent for an account; a later re-authorization can omit it. Without one the mailbox could never sync in the background, so a connection with no refresh token, old or new, is refused rather than saved as connected. Removing Xuda from your Google account's permissions and connecting again gets a fresh one.
Disconnecting a Gmail account revokes the OAuth token with Google as part of removing it, so the grant does not sit live on Google's side after Xuda stops using it.
Claim a hosted mailbox
A hosted mailbox is a real address on @xuda.app, provisioned on Xuda's own mail server, with no
outside account involved at all.
Pick a name
Typed as-is if you give one; left blank, Xuda suggests one that is free.
Xuda checks you can have it
Your plan must include a hosted mailbox at all, there must be room under your plan's connected-account limit (the same limit a connected Gmail account counts against), and your account must already be at the identity verification level a mailbox needs, the same one a phone number needs, because a mailbox is an addressable identity other people receive mail from.
It is provisioned and billed
A mailbox carries its own monthly charge on paid tiers, charged before the mailbox exists so a failed payment never leaves you with one and a bill for nothing; the free tier includes one hosted mailbox with no charge at all.
Sending
Outbound mail, whether from the platform's own address or from a connected mailbox, goes out through the same Stalwart submission path and answers the same success and failure shape. See Send an email for the exact call and response, and AImail for reading, managing and sending from a specific connected mailbox once one exists.