> For the complete documentation index, see [llms.txt](https://docs.pagerly.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pagerly.io/incidents-and-alerting/integrations/aws-sns.md).

# AWS SNS

Use this when you want alerts from AWS services other than CloudWatch alarms - anything that can publish to an SNS topic. For CloudWatch alarms specifically, use [AWS Cloudwatch](/incidents-and-alerting/integrations/aws-cloudwatch.md), which understands the alarm payload directly.

### Create the integration in Pagerly

1\. Navigate to <https://workspace.pagerly.io/inbound> and click **"Add Inbound Integration"**.

2\. Set a display name, select the team this integration belongs to, choose the integration below, and click **"Add Integration"**.

3\. Copy the generated webhook URL - you will paste it into the tool in the next section.

### Configure AWS SNS

1\. In the AWS console open **SNS → Topics** and select or create a topic.

2\. Click **Create subscription**.

3\. Set **Protocol** to `HTTPS` and paste the Pagerly webhook URL into **Endpoint**.

4\. Create the subscription. Pagerly confirms it automatically.

### Notes

* **Deduplication** uses the SNS `Subject`, not `MessageId` - `MessageId` is unique to every delivery, so keying on it would open a new incident each time. Give your publishers a stable, meaningful `Subject`.
* If `Message` contains JSON, Pagerly unwraps it and maps fields from inside. Plain-text messages are used as-is.