< Back

Endpoint: Amazon SNS

marbot endpoints can receive messages from Amazon SNS. Luckily, many AWS services send events to SNS topics and, therefore, to marbot.

Creating an SNS topic

marbot helps you to create an SNS topic:

  1. Add marbot to Slack or Microsoft Teams.
  2. Invite marbot to a channel.
  3. Send @marbot Create an SNS topic to the channel.
  4. Follow the wizard in the channel.

AWS examples

3rd party examples


marbot checks if the X-Alert-Key message attribute is present. Incoming events with the same X-Alert-Key value result in a single alert.

Otherwise, marbot looks at the payload:

  • If the message originates from an AWS services, marbot uses AWS context knowledge to aggregate incoming events.
  • If only one field is transmitted, marbot aggregates incoming events with the same field value.
  • If more than one field is transmitted, marbot aggregates incoming events with the same field keys.


marbot might not be reachable (request timeout, connection error) or might respond with HTTP status codes of 500-599. In all those cases, SNS retries message delivery to marbot until marbot response with HTTP status code 204.

To avoid alert duplicates in the case of retries, marbot uses the MessageId on SNS messages for uniqueness. Each message id can only be used once every ~24 hours.

More help needed? Or want to share feedback?

If you experience any issues, let us know.

E-mail icon
marbot teaser

Chatbot for AWS Monitoring

Configure monitoring for Amazon Web Services: CloudWatch, EC2, RDS, EB, Lambda, and more. Receive and manage alerts via Slack. Solve incidents as a team.

Add to Slack
Microsoft Teams
Add to Teams