Set up SMTP server for sending email

Tutorial: Set up your own SMTP server to send documents by email.

Content 

  1. Choose Mail Sending Method
  2. SMTP with Basic Auth
  3. Setting up an OAuth Connection
  4. Send document by e-mail
  5. Good to know / Trobleshooting

Watch tutorial (German)

Screenshot of the user profile settings with the SMTP tab

If documents such as offers, delivery bills or invoices are sent via CashCtrl by email, this is done by default from the address accounting@cashctrl.com. In order to send emails via your own email account, an SMTP server must be configured in CashCtrl.

The advantages are that your own email address appears as the sender address, and you receive any bounce messages in case of non-delivery.

1. Choose Mail Sending Method

Go to Settings User Profile SMTP Connections. Open the dialog via Add. In the dropdown menu, you can select the SMTP connection type:

  • SMTP with Basic Auth: The classic connection using username & password via a custom host/port.
  • OAuth 2: Required for Google (Mail/Workspace) and Microsoft (365/Entra)
Screenshot of the add SMTP Connection Dialog in CashCtrl with available Connection Types

2. SMTP with Basic Auth

To set up the connection, you need the details provided by your email provider. The following information must be entered in CashCtrl:

  • Email address
  • Password: The login password for your email provider (or the app password, see Good to Know below)
  • Host: Enter the server name, e.g., smtp.mycompany.com. It is recommended to use the mail server of the email address in your user profile, as this is the address from which emails will be sent.
  • Port: Your provider will specify the port based on security settings. By default, TLS/STARTTLS uses port 587, but SSL with port 465 is also possible.
  • For organizations: By default, "All" is selected, but you can specify which SMTP connection to use for each organization.

Finally, click Save. A connection test will be performed. If successful, the connection will be saved.

Screenshot of the user settings for setting up the SMTP server for sending emails in CashCtrl.

3. Setting up an OAuth Connection

If OAuth (Google or Microsoft) is selected from the dropdown menu and you click Next, the Google or Microsoft login page will open for you to sign in to the respective account. You will be asked "Trust CashCtrl?" — confirm with Next to grant permission for "Send emails on your behalf".

Screenshot of the Login Screen to add an OAuth Connection with Google

4. Send documents by email

Order documents can be sent by e-mail in the overview in the Orders module by right-clicking Send document or in the preview view by clicking the Send e-mail button. The send window opens, in which the following information can be entered:

  • To: enter one or more (comma separated) recipients here, e.g. info@galeriexy.ch, finanzen@galeriexy.ch
  • From:
    • Without SMTP: this field is equal to "reply-to". This means that if the recipient replies to this email, the reply will be sent to the reply-to address.
    • With SMTP: if the field remains empty, the address of the CashCtrl user is specified as the From address. If an address is entered here, it overwrites the email address of the user.
  • CC: address for recipients of a copy of the message, visible to all other recipients.
  • BCC: same as CC, only invisible for other recipients.gleiches wie CC, nur unsichtbar für andere Empfänger:innen.
  • Subject: placeholders can also be used here as in the text.

Once all the information has been entered, click on Preview to open a preview. Confirm the query whether the e-mail should be sent with Yes — done.

Screenshot of the draft dialog when sending documents by email from CashCtrl

Good to know / Troubleshooting

  • With Google and Microsoft - even without two-factor authentication - an app password must be generated and entered instead of the normal password.
  • If two-factor authentication has been activated at the email provider, a so-called app password must be entered in the CashCtrl settings dialog instead of the normal password. This password can be generated by services like Google or Microsoft and is used to authorize services like CashCtrl to send emails without two-factor authentication.
    For instructions from your email provider, it is best to enter the following into a search engine: "XYZ app password smtp two factor authentication". XYZ = e.g. Gmail, Microsoft 365 etc.
  • If an error message such as "535 Authentication unsuccessful" appears when you click on "Test connection", this is due to the following possible reasons:

    • Incorrect password Check whether the correct password is being used for the e-mail account. Alternatively, check whether 2-FA has been set up with the mail provider and an app password is required instead of the normal password.

    • Incorrect SMTP server, incorrect port Check the details of the mail provider.

CashCtrl light bulb