Soracom Flux

Email Notification Action (Advanced)

The Email Notification Action (Advanced) sends an email to the specified email address and supports attaching images.

Configuration

In the Action Condition input field, you can specify the conditions under which the action will be executed using the values (Message or Context) from the event source to the channel. For details on supported expressions, refer to Use Expressions in Actions.

Configuring Email Notification Action (Advanced)

The Subject, Body, and Attachment Image URL fields support expressions.

• To: Enter the recipient's email address.
• CC: Enter the email address to add as a CC recipient.
• BCC: Enter the email address to add as a BCC recipient.
• Subject: Enter the email subject.
• Body: Enter the email body.
• Attachment Image URL: Enter the URL of the image to attach to the email.
  • The total size of all attachments must not exceed 2 MB. Exceeding this limit results in an error.
  • Example expressions: ${event.payload.imageUrl}, ${payload.imageUrl}.

Output

Set up how the action's output data will be processed. Refer to Enable Republishing of Action Output for more details.

Attachment Image URL Examples

Specifying Multiple Image URLs Individually

You can specify image URLs individually in the Attachment Image URL field. Click to add additional input fields.

• First Attachment Image URL: ${payload.imageUrl01}
• Second Attachment Image URL: ${payload.imageUrl02}

Using Output from the Collect Messages Action

When using the Collect Messages Action, image URLs are returned as an array. In this case, you can specify the array directly.

• Attachment Image URL: ${payload.image}

For example, if the following array is stored in payload.image, three images will be attached to the email:

[
  "https://example.com/image1.jpg",
  "https://example.com/image2.png",
  "https://example.com/image3.png"
]

Verifying Email Address Deliverability

When you enter an unverified email address as a recipient, a message Deliverability verification is required is displayed. Verify the deliverability as follows:

1. Click Send verification email.

   A verification email is sent to the address, and Waiting for verification is displayed. If the email does not arrive, click Send verification email again.

2. Click the link in the verification email within 24 hours of sending it.

   The deliverability is verified, and a check mark is displayed to the right of the email address. If the link has expired, send the verification email again.

Switching an Existing Advanced Email Notification Action to Direct Entry

An Email Notification Action (Advanced) that has not been switched to direct entry selects its recipients from the email addresses added to the Soracom account. In this mode, only the root user can set the recipients, and only email addresses that have already been added to the account are available. For details on adding an email address to a Soracom account, refer to Adding an Email Address.

After you switch to entering email addresses directly, SAM users can also set the recipients.

1. In the action's configuration, click Switch to entering email addresses directly.

   The current recipients are carried over, and the deliverability of each email address is checked.

2. Verify the deliverability of every address shown as unverified.

   For the procedure, refer to Verifying Email Address Deliverability.

3. Save the action settings.

   Switching alone does not save the action settings.

Output Data of the Action

When the email is added to the send queue by the Email Notification Action (Advanced), a response is returned containing the recipients and usage information. For example:

{
  "sent": {
    "to": ["user@example.com"]
  },
  "usage": [
    {
      "curr": 4,
      "limit": 10,
      "resetAt": "2026-03-02T10:20:37Z"
    }
  ]
}

The usage array contains rate limit information for the action. Depending on your plan, this array may include one or more limit periods: