Docs / Strand / connectors/aws-sns

AWS SNS

Direction: Write Only | Type: aws.sns

Amazon Simple Notification Service connector for publishing messages to SNS topics. This is a forward-only connector: data is sent to SNS and no response data is returned beyond confirmation.

Required Permissions#

The IAM user or role must have the following permissions:

Operation Required IAM Permissions
publish sns:Publish
Tip: Scope permissions to specific topic ARNs to follow the principle of least privilege.

Operations#

Operation Direction Description
publish Write Publish a message to an SNS topic

Connector Configuration#

Field Required Default Description
Authentication Type No api_key Uses explicit credentials (the fields below).
Region Yes - AWS region code (e.g., us-east-1)
Endpoint URL No - Custom endpoint for a self-managed target or an AWS VPC endpoint. Leave empty for AWS.
Access Key ID Conditional - AWS access key (encrypted). Required when Authentication Type is api_key
Secret Access Key Conditional - AWS secret key (encrypted). Required when Authentication Type is api_key
Topic ARN No - Default SNS topic ARN (can be overridden at node level)

Node Configuration#

Field Required Description
Topic ARN No SNS topic ARN (overrides connector default)
Subject No Message subject (default: Event Notification)

Output#

json

{
  "success": true,
  "status": "sent",
  "data": {
    "message_id": "abc-123",
    "topic_arn": "arn:aws:sns:us-east-1:123456789:my-topic"
  },
  "service": "aws.sns",
  "operation": "publish"
}

Example#

Connector Setup:

json

{
  "region": "us-east-1",
  "access_key_id": "AKIAIOSFODNN7EXAMPLE",
  "secret_access_key": "wJalrXUtnFEMI/K7MDENG...",
  "topic_arn": "arn:aws:sns:us-east-1:123456789:alerts"
}

Node Configuration: