Email Connector

  • Latest Dynatrace
  • 3-min read

You can automate sending out-of-the-box emails using Email Connector Email for Workflows based on the events and schedules defined by your workflows.

Set up Email integration

Step 1

Install Email Connector

Step 2

Grant permissions to Workflows

Grant permissions to Workflows

Workflows require certain permissions to run actions on your behalf. Other permissions are required by actions that come bundled with Email Connector.

To fine-tune permissions granted to Workflows

  1. Go to Workflows Workflows and go to Settings > Authorization settings.
  2. Select the following permissions besides the general Workflows permission.
    • Permissions needed for Send email actions
      • email:emails:send

For more on general Workflows user permissions, see Expression reference.

Trial environments are prohibited to send emails with Email Connector.

Send an email with workflows

  1. Go to Workflows Workflows and select Add Workflow to create a new workflow.
  2. Select the Trigger to choose the right trigger for your needs.
  3. In the side panel, select one of the triggers.
  4. On the trigger node, select Add task Add to browse available actions.
  5. In the side panel, search the actions for Email and select Send email.
  6. In To field, enter the email addresses of the recipients. The Cc, Bcc fields, are also available. For To, Cc, and Bcc fields the number of email addresses is restricted to 10 per field.
  7. In Subject and Message fields, enter a meaningful text.
  8. Select Run.

Email Connector sends emails from no-reply@apps.dynatrace.com email address. We recommend whitelisting the domain to avoid emails being redirected to the junk folder.

Format email

To format the body of an email

  1. Select Message.

  2. Enter your text.

    When you select, for example, the bold style, your text is rendered as bold in the sent email. You won't be able to preview it without the formatting symbols. However, when you send an email, the recipient will see the properly formatted text, and the formatting symbols won't be visible.

    You can use the toolbar to insert common elements like a heading, bold text, or a link.

    Attaching an image or inserting JavaScript code into the email body is impossible. It's just shown as plain text.

    Screenshot of a workflow with an email action where the email body text can be formatted.

Format syntax

Italics

Wrap text in single asterisks (*like this*) to get italics like this.

Bold

Wrap text in double asterisks (**like this**) to get bold text like this.

Strikethrough

Wrap text in double tildes (~~like this~~) to get strikethrough (crossed out) text like this.

Code

  • Wrap text in backticks (`like this`) to get bold text like this.

  • Wrap text in triple backticks (```like this```) to show a code block (multiple lines of code text).

Headings

To add a heading, start the line with the # character like this: # This is your heading text.

Horizontal line

To visually separate sections of your annotation, add a horizontal line with three dashes (---):

Lists

Each line of an unordered (bulleted) list starts with an asterisk (*):

* Line 1
* Line 2

Alternatively, you can use a dash (-):

- Line 1
- Line 2

An ordered (numbered) list starts with a number and a period (1.) followed by a space and then your text:

1. The first line of my procedure.
2. The second line of my procedure.
3. The third line of my procedure.

Tables

To add a table, define the headers, the column formatting row, and then the rows of data you want to display

| Header 1 | Header2
 --- | ---
 content2 | content2
Header 1
Header2
content2
content2

To link to a website, use this format:

[Example text label](https://www.example.com)

Here's a link to the [Dynatrace website](www.dynatrace.com).

Line break

To add a single line break and a new line, select Enter in the Message field of the Connector.

No HTML support

This Connector only allows formatting of the message body using the listed formatting options. It doesn't offer support for HTML.

Inputs

Field
Description
Required
To
The recipients of the email.
required
Cc
The cc recipients of the email.
required
Bcc
The bcc recipients of the email.
required
Subject
The subject of the email.
required
Content
The content of the email.
required

You must enter at least one and a maximum of ten recipients in one of the fields (to, cc, bcc). If you are using expressions for the recipients, the expressions must be evaluated as a list of email addresses, for example, ["user1@domain.com", "user2@domain.com"].

Action result

The Send email action provides the following result.

Property

Description

requestId

A unique identifier to trace successfully accepted email send requests.

clientRequestId

A unique identifier to trace successfully accepted email send requests. For sending emails, this is identical to requestId.

Expected behavior 'Failed to send email. Status code 403.'

This message is related to missing permissions or a trial environment as described above in Grant permissions to Workflows.

Sending JSON payloads as message content

When sending an object or non-string data as message content, ensure it is properly formatted as a string. The recommended approach is to wrap your input in an expression and convert it to a JSON string using the to_json filter:

{{ result("run_javascript_1") | to_json }}

This approach ensures your data is properly formatted for transmission. For more information, see Expression reference.

Related tags
Software Delivery