Troubleshoot SMTP channel

Use this guide to diagnose and resolve common issues with the SMTP channel in Turbo360. The two most frequent causes of email notification failures are incorrect SMTP credentials and network connectivity problems between Turbo360 and the SMTP server.

Incorrect SMTP credentials

If Turbo360 cannot authenticate with your SMTP server, test the connection outside of Turbo360 first. The PowerShell scripts below let you validate your credentials and confirm that email delivery works before reconfiguring Turbo360.

Update the $smtpServer, $from, $to, $username, and $password variables with your actual values before running each script.

Email without SSL


# Set variables
$smtpServer = ""  # Replace with your SMTP server
$smtpPort = 25                  # Common ports: 25, 587, or 465
$from = ""        # Sender email address
$to = ""    # Recipient email address
$subject = "Test Email from PowerShell"
$body = "This is a test email sent via PowerShell."
$username = "Add your username here"   # Your SMTP username (if required)
$password = "Add your password here"   # Your SMTP password (if required)

# Create a secure password object
$securePassword = ConvertTo-SecureString $password -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($username, $securePassword)

# Send email
Send-MailMessage -SmtpServer $smtpServer -Port $smtpPort -From $from -To $to -Subject $subject -Body $body -BodyAsHtml -Credential $credential

Email with SSL

# Set variables
$smtpServer = ""  # Replace with your SMTP server
$smtpPort = 587                  # Common ports: 25, 587, or 465
$from = ""        # Sender email address
$to = ""    # Recipient email address
$subject = "Test Email from PowerShell"
$body = "This is a test email sent via PowerShell."
$username = "Add your username here"   # Your SMTP username (if required)
$password = "Add your password here"   # Your SMTP password (if required)

# Create a secure password object
$securePassword = ConvertTo-SecureString $password -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($username, $securePassword)

# Send email using SSL
Send-MailMessage -SmtpServer $smtpServer -Port $smtpPort -From $from -To $to -Subject $subject -Body $body -BodyAsHtml -Credential $credential -UseSsl

Email with SendGrid via SMTP

If you are using SendGrid, note the following before running the script:

Use apikey as the username — this is a literal string, not a placeholder.
Use your SendGrid API key as the password.
Your sender address must be a validated sender in SendGrid.

# Set variables
$smtpServer = "smtp.sendgrid.net"  # Replace with your SMTP server
$smtpPort = 587                  # Common ports: 25, 587, or 465
$from = ""        # Sender email address
$to = ""    # Recipient email address
$subject = "Test Email from PowerShell"
$body = "This is a test email sent via PowerShell."
$username = "apikey"   # Your SMTP username (if required)
$password = "[Your API Key goes here]"   # Your SMTP password (if required)

# Create a secure password object
$securePassword = ConvertTo-SecureString $password -AsPlainText -Force
$credential = New-Object System.Management.Automation.PSCredential ($username, $securePassword)

# Send email using SSL
Send-MailMessage -SmtpServer $smtpServer -Port $smtpPort -From $from -To $to -Subject $subject -Body $body -BodyAsHtml -Credential $credential -UseSsl

No network connectivity to SMTP server

If the PowerShell scripts above succeed but Turbo360 still cannot send email, the most likely cause is that Turbo360 does not have network access to your SMTP server. Review the relevant causes for your hosting model below.

Turbo360 SaaS Hosting	Turbo360 Private Hosting
Check whether your SMTP server has a firewall rule that blocks inbound connections from Turbo360.	If your Turbo360 Private Hosting instance uses an Azure VNet, check whether an NSG or firewall rule is preventing outbound connections from Turbo360 to the SMTP server.

Troubleshooting

Emails are not being sent from Turbo360.
Verify your SMTP credentials using the PowerShell scripts above. If the scripts succeed but Turbo360 still fails, check network connectivity between your Turbo360 instance and the SMTP server.
PowerShell script returns an authentication error.
Your SMTP username or password is incorrect. Double-check the credentials and ensure the SMTP account has permission to relay email. For SendGrid, confirm that apikey is used as the username and that a valid API key is provided as the password.
PowerShell script times out when connecting to the SMTP server.
The SMTP port may be blocked by a firewall. Try an alternative port (25, 587, or 465) and confirm the port is open between the machine running the script and the SMTP server.
Emails are sent successfully from PowerShell but not from Turbo360.
Turbo360 likely cannot reach the SMTP server due to a network restriction. For SaaS hosting, check for firewall rules on the SMTP server side. For Private Hosting, review NSG and firewall rules on your Azure VNet.
SendGrid rejects the sender address.
The From address must be a verified sender identity in SendGrid. Navigate to Settings > Sender Authentication in SendGrid and verify the address before retrying.