Skip to main content

Your App's Own Mail

Strongly sends emails for your app: the codes that confirm a new account's email, password-reset codes, the notice to an address that already has an account when someone tries to sign up with it, invitations to the app and paid-access team invites. By default they come from the platform's own address, under your app's name.

Give your app its own mail settings and every one of those emails goes through your SMTP server, from your address, instead. Remove the settings and they go back to the platform's address. There is no mix: an app either has mail settings and all its emails use them, or it has none.

Set it up​

Open the app, go to the Settings tab and find Mail.

FieldWhat to enter
SMTP serverThe host name of your mail provider's SMTP server, such as smtp.example.com (no smtp://, no port)
SecuritySTARTTLS (required): the connection is upgraded to TLS, and a server that does not offer TLS is refused (usually port 587). TLS: TLS from the first byte (usually port 465). Plain, unencrypted connections are never used
PortThe port your provider gives for that security: usually 587 or 465
User nameThe SMTP user name
PasswordThe SMTP password, or the app password / API key your provider issues for SMTP
From addressThe address the emails are sent from, such as hello@example.com. Your SMTP server must accept it as a sender (many providers require the domain to be verified with them)
From name (optional)The name people see with the address. Empty shows your app's name

Select Save. A field that is missing or not valid is highlighted with what to change.

The password is write-only: it is stored encrypted and never shown again, by the page, the API or any log. The page shows whether one is Set; select Replace to enter a new one. Saving without replacing keeps the stored password.

No Reply-To is added to the emails: replies go to the From address.

Send a test email​

After saving, select Send test email. One email is sent through your saved settings to the address of the account you are signed in with. The page shows Delivered with your mail server's answer, or Refused with the error your mail server gave (for example a wrong password or a sender address it does not allow). The error never contains your password. Each click sends one email.

Go back to the platform's address​

Select Remove on the Mail card. The settings and the stored password are deleted, and your app's emails are sent from the platform's address again. Deleting the app also deletes its mail settings.

Who can change it​

The app's owner, its app admins and administrators: the same people who configure the app's sign-in, since these emails carry its sign-in codes. Everyone else sees that they cannot manage the app's mail. Every change (and every test email) is recorded in the audit log with the settings that were set, never the password.

From the API, the Python SDK and STAN​

RESTPython SDKSTAN / agent tool
ReadGET /api/v1/apps/:id/mailclient.apps.mail(app_id)get_app_mail
SetPATCH /api/v1/apps/:id/mailclient.apps.update_mail(app_id, ...)update_app_mail
RemoveDELETE /api/v1/apps/:id/mailclient.apps.delete_mail(app_id)delete_app_mail
TestPOST /api/v1/apps/:id/mail/testclient.apps.send_test_email(app_id)send_app_test_email

See Apps API: Mail for the request and response fields.