Learn how to use the Signalgrid Mail Gateway
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.coReplace
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.
Example: Regular Notification
To: 7e4c9b2f5d3a1c8e6f4b0d9a2e7c1f6b@notify.signalgrid.co
Subject: a3f29c8f Server Down
Server at web.example.com is downIn this example:
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.
[is-critical][type-crit][type-warn][type-info][type-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.