= SMTP plugin :toc: macro

The SMTP plugin provides alerts that send e-mail messages over SMTP.

== Alerts

=== smtp.send

[source,goplum]

alert smtp.send "example" { server = "mail.example.com:25" username = "goplum" password = "example" subject_prefix = "ALERT: " from = "[email protected]" to = "[email protected]" }

Sends an e-mail message via an SMTP server. All parameters are required except for subject_prefix which defaults to "Goplum alert: ".

If the SMTP server supports STARTTLS, the connection will switch to use TLS prior to sending any authentication details.

If you do not run your own SMTP server, you might consider using a dedicated service such as https://www.mailgun.com/[mailgun] or https://aws.amazon.com/ses/[AWS SES], both of which you can access over SMTP.