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:
- Subject:
Alert: {{ payload.alert_type }}
Tendrl