The Email integration lets Qualytics send Flow email notifications through your own email (SMTP) server. Connect it when you want notification emails to come from your organization's mail service, with your own sender address, instead of the platform's default email service.
Let's get started 🚀
How Email Delivery Works
Qualytics decides how to deliver notification emails in this order:
- Email integration: when an Email integration is connected, every notification email is sent through your server with your sender address.
- Platform default: without an Email integration, emails are sent through the platform's default email service, when your deployment provides one. Managed deployments include a default email service; self-hosted deployments can configure one at installation time.
- Not configured: if neither is available, email notifications are not delivered.
The two configurations never mix. Either your integration handles all notification email, or the platform default does.
Tip
The Email card in Settings > Integrations tells you which state you are in. When no integration is connected, the card indicates whether email notifications already work through the platform's default email service or are not enabled yet.
Permissions
Managing integrations requires the Manager or Admin role.
Navigation to Integration
Step 1: Log in to your Qualytics account and click the "Settings" button on the left side panel of the interface.
Step 2: By default, Connections tab will open. Click on the Integrations tab.
Connect Email Integration
Step 1: Click on the Connect button next to Email under the Alerting section.
A modal window titled "Add Email Integration" appears. Fill in the connection properties for your email server.
Step 2: Fill out the connection properties:
| No. | Field Name | Description |
|---|---|---|
| 1. | SMTP Server | The hostname of your email server (e.g., smtp.example.com). Enter the bare hostname, without http:// or https://. |
| 2. | Port | The connection port. 465 uses implicit TLS (the default), 587 uses STARTTLS, and 25 is plain SMTP. Port 25 is unencrypted and sends credentials in cleartext, so it is not recommended. |
| 3. | Sender Email | The From address for notification emails sent by Qualytics (e.g., no-reply@yourcompany.com). |
| 4. | Username | The username used to sign in to your email server. |
| 5. | Password | The password used to sign in to your email server. The integration only supports servers that require sign-in. |
| 6. | Verify TLS Certificates | Enabled by default. Disable it only when your email server uses a self-signed or private certificate. This setting applies to the Email integration only and does not affect any other connection. |
Step 3: Click the Validate button to confirm the settings work before saving. Qualytics connects to your server, signs in with the provided credentials, and sends a test email to your own address. Check your inbox to confirm delivery.
Note
If any required field is empty, the form highlights it instead of contacting the server. If the connection or sign-in fails, an error message explains what went wrong. The password is never included in error messages.
Step 4: Click the Create button to save the integration. Qualytics verifies the connection and credentials again as part of saving, so an unreachable server or wrong password is rejected and nothing is stored until the settings are valid.
A success message appears once the integration is created. From this point on, all Flow email notifications are sent through your server.
Manage Email Integration
Edit Integration
Step 1: Click on the vertical ellipses (â‹®) next to the Connected button and select the Edit option.
Step 2: A modal window Edit Email Integration appears, allowing you to change the connection properties.
The Password field is empty when editing. Leave it empty to keep the saved password, or enter a new one to change it. The Validate button is also available while editing and uses the saved password when the field is left empty.
Step 3: Click the Update button to apply the changes. Qualytics verifies the connection again with the updated settings before saving them.
A success message appears once the integration is updated.
Disconnect Integration
Step 1: Click on the vertical ellipses (â‹®) next to the Connected button and select the Disconnect option.
Step 2: A modal window Disconnect Integration appears, explaining what happens when the integration is removed.
Step 3: Click the Disconnect button to proceed.
Note
After disconnecting, email notifications fall back to the platform's default email service when one is available; otherwise email delivery stops. Emails already sent through your server remain in the recipients' inboxes.
A success message appears once the integration is disconnected.
Using Email in Flows
Once email delivery is available, through either the Email integration or the platform default, you can add Email notification actions to your Flows with recipient addresses, a subject, and a message template. For details, see the Email Notification documentation.