MailSend

yaml

type: "io.kestra.plugin.notifications.mail.MailSend"

Send an automated email from a workflow

Examples

Send an email on a failed flow execution

yaml

id: unreliable_flow
namespace: company.team

tasks:
  - id: fail
    type: io.kestra.plugin.scripts.shell.Commands
    runner: PROCESS
    commands:
      - exit 1

errors:
  - id: send_email
    type: io.kestra.plugin.notifications.mail.MailSend
    from: hello@kestra.io
    to: hello@kestra.io
    username: "{{ secret('EMAIL_USERNAME') }}"
    password: "{{ secret('EMAIL_PASSWORD') }}"
    host: mail.privateemail.com
    port: 465 # or 587
    subject: "Kestra workflow failed for the flow {{flow.id}} in the namespace {{flow.namespace}}"
    htmlTextContent: "Failure alert for flow {{ flow.namespace }}.{{ flow.id }} with ID {{ execution.id }}"

Properties

`attachments`

Type: array
SubType: MailSend-Attachment
Dynamic: ✔️
Required: ❌

Adds an attachment to the email message

The attachment will be shown in the email client as separate files available for download, or displayed inline if the client supports it (for example, most browsers display PDF's in a popup window)

`cc`

Type: string
Dynamic: ✔️
Required: ❌

One or more 'Cc' (carbon copy) optional recipient email address. Use semicolon as delimiter to provide several addresses

Note that each email address must be compliant with the RFC2822 format

`embeddedImages`

Type: array
SubType: MailSend-Attachment
Dynamic: ✔️
Required: ❌

Adds image data to this email that can be referred to from the email HTML body

The provided images are assumed to be of MIME type png, jpg or whatever the email client supports as valid image that can be embedded in HTML content

`from`

Type: string
Dynamic: ✔️
Required: ❌

The address of the sender of this email

`host`

Type: string
Dynamic: ✔️
Required: ❌

The email server host

`htmlTextContent`

Type: string
Dynamic: ✔️
Required: ❌

The optional email message body in HTML text

Both text and HTML can be provided, which will be offered to the email client as alternative contentEmail clients that support it, will favor HTML over plain text and ignore the text body completely

`password`

Type: string
Dynamic: ✔️
Required: ❌

The email server password

`plainTextContent`

Type: string
Dynamic: ✔️
Required: ❌

The optional email message body in plain text

Both text and HTML can be provided, which will be offered to the email client as alternative contentEmail clients that support it, will favor HTML over plain text and ignore the text body completely