Signalgrid Mail Gateway

Updated on May 17, 2026

Learn how to use the Signalgrid Mail Gateway
to trigger notifications via email.

Signalgrid provides a mail gateway that allows you to trigger notifications simply by sending an email.
This makes it easy to integrate systems that can send emails but do not support HTTP APIs.

Mail Gateway Address

Each channel has its own email address that can receive specially formatted emails and turn them into notifications.
The address uses the following format:

CHANNEL_TOKEN@notify.signalgrid.co

Replace CHANNEL_TOKEN with the token of the channel that should receive the notification.
You can find the CHANNEL_TOKEN on the detail-page of the channel.

Email Format

The email subject must begin with your client_key. Everything after the first space is used as the notification title.

Email Field
Usage
Subject
The client key followed by a space and the notification title.
Body
The body of the email becomes the notification message.

Example: Regular Notification

To: 7e4c9b2f5d3a1c8e6f4b0d9a2e7c1f6b@notify.signalgrid.co
Subject: a3f29c8f Server Down

Server at web.example.com is down

In this example:

Part
Result
7e4c9b2f5d3a1c8e6f4b0d9a2e7c1f6b
Your Channel Token
a3f29c8f
Your client-key
Server Down
Notification title
Server at web.example.com is down
Notification message

Additional Options

Additional options can be defined inside the email body using tags. These tags modify how the notification is delivered.
Place these anywhere in your mail-body, and our Mail Gateway will process them.

Tag
Effect
[is-critical]
Delivers the notification as a critical alert.
[type-crit]
Sets the notification type to CRIT.
[type-warn]
Sets the notification type to WARN.
[type-info]
Sets the notification type to INFO.
[type-success]
Sets the notification type to SUCCESS.

Example: Critical Notification

To: 7e4c9b2f5d3a1c8e6f4b0d9a2e7c1f6b@notify.signalgrid.co
Subject: a3f29c8f Server Down

The production server stopped responding.
[type-crit] [is-critical]

This example will trigger a critical notification.
[type-crit] Sets the severity to CRIT, and will cause the notification to be shown in red color.
[is-critical] This causes the notification to be delivered as a Critical Notification, which will bypass DND, and depending on device-type - will be louder, and visibly different from regular notifications ( Example: iOs )

How It Works

When the email arrives at the Signalgrid mail gateway, the message is processed and converted into a notification using the same system that handles API requests. The notification is then delivered to all devices subscribed to the selected channel.

This allows systems that can only send emails to integrate with Signalgrid and trigger real-time notifications.