Send notifications to Signalgrid using 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.
When an email is received by the Signalgrid mail gateway, it is converted into a notification and delivered to the selected channel.
Mail Gateway Address
Each channel can receive notifications through the mail gateway. To
trigger a notification, send an email to
CHANNEL_TOKEN@notify.signalgrid.coReplace
CHANNEL_TOKEN with the token of the channel that should
receive the notification.
Email Format
The email subject must begin with your client key.
Everything after the first space is used as the notification title.
Example Email
To: 7e4c9b2f5d3a1c8e6f4b0d9a2e7c1f6b@notify.signalgrid.co
Subject: a3f29c8f Server Down
The production server stopped responding.In this example:
Notification 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 Email
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 critical, 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.