Email Notification Action

The Email Notification action sends an email to the specified email address.

On the Developer plan, you can send up to 100 emails per month per Soracom Account, with a maximum of 10 emails per hour. If notifications exceed these limits, they will be discarded and not resent. Other plans may have different limits. See Plans for details.

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

The Subject and Body fields support expressions.

To: Select the recipient's email address.
CC: Select the email address to add as a CC recipient.
BCC: Select the email address to add as a BCC recipient.
Subject: Enter the email subject.
Body: Enter the email body.

Only the Root user can set the email addresses for email recipients. SAM users cannot set this.
You can only select email addresses that have already been added to the operator. For more details on adding an email address to the operator, refer to Adding an Email Address.

Output

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

Output Data of the Action

When the Email Notification Action successfully sends an email, 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"
    },
    {
      "curr": 30,
      "limit": 100,
      "resetAt": "2026-03-12T09:10:53Z"
    }
  ]
}

If CC or BCC recipients are included, they also appear in the response:

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

The usage array contains rate limit information for the action. Depending on your plan, this array may include one or more limit periods (such as hourly and monthly):

Field	Description
`curr`	The number of emails sent in the current period.
`limit`	The maximum number of emails allowed in the period.
`resetAt`	The time (in UTC) when the counter resets.

This response confirms that the email was sent, but does not confirm receipt of the email by the recipient.