SMTP for Home Assistant (built-in integration)

About

SMTP is a built-in Home Assistant integration that sends email notifications through an SMTP server. It adds a notifier and a send message action, so automations can send email. The connection takes the server host, port, username, password, sender email and sender name, and offers a choice of STARTTLS, SSL/TLS or no encryption. Certificate verification can be switched on for secure connections. Options cover a Reply-To address and name, plus a connection timeout that defaults to 60 seconds. It is set up in the UI, and a repair notice appears if an older YAML configuration fails to import.

Automatic summary of Home Assistant's source code. Something wrong? Get in touch

Supports

Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Set up in the UI Add it in Settings, Devices and services. Nothing to download.
Updated with Home Assistant Ships and updates with every Home Assistant release.

Setting it up

It is added under Settings, Devices and services, with Add integration.

Connect

Connection securityEncryption method used for the SMTP connection. STARTTLS upgrades a plain connection to encrypted (recommended). SSL/TLS uses encryption from the start. None sends without encryption.
PasswordPassword or app-specific password for the SMTP account.
PortPort number used by your SMTP server. Common values are 587 (STARTTLS) and 465 (TLS).
Sender emailEmail address that will appear in the From field.
Sender nameDisplay name shown as the email sender.
HostHostname or IP address of the SMTP server. For example, smtp.example.com.
UsernameUsername used to authenticate with the SMTP server.
Verify SSL certificateEnable certificate verification for secure SSL/TLS connections.
Reply-To email addressEmail address to use for recipient replies. If not specified, the sender's email address is used.
Reply-To nameDisplay name shown as the Reply-To name.
Connection timeoutMaximum time to wait for a response from the SMTP server before the connection attempt is aborted. Defaults to 60 seconds.

Re-authenticate SMTP

PasswordPassword or app-specific password for the SMTP account.
UsernameUsername used to authenticate with the SMTP server.

Reconfigure SMTP

Connection securityEncryption method used for the SMTP connection. STARTTLS upgrades a plain connection to encrypted (recommended). SSL/TLS uses encryption from the start. None sends without encryption.
PasswordPassword or app-specific password for the SMTP account.
PortPort number used by your SMTP server. Common values are 587 (STARTTLS) and 465 (TLS).
Sender emailEmail address that will appear in the From field.
Sender nameDisplay name shown as the email sender.
HostHostname or IP address of the SMTP server. For example, smtp.example.com.
UsernameUsername used to authenticate with the SMTP server.
Verify SSL certificateEnable certificate verification for secure SSL/TLS connections.

After setup

Reply-To email addressEmail address to use for recipient replies. If not specified, the sender's email address is used.
Reply-To nameDisplay name shown as the Reply-To name.
Connection timeoutMaximum time to wait for a response from the SMTP server before the connection attempt is aborted. Defaults to 60 seconds.

Texts from Home Assistant's source code, Apache License 2.0.