Docs / Contact / connectors/aws-sns
AWS SNS
Provider:aws| Service:sns| Direction: Write
Amazon Simple Notification Service connector for publishing messages to an SNS topic. This is a forward-only connector.
Required Permissions#
| Operation | Required IAM Permissions |
|---|---|
| Publish | sns:Publish |
Tip: Scope permissions to the specific topic ARN to follow the principle of least privilege.
Operation#
When a message reaches this connector, it publishes to the configured topic. The payload must supply:
| Payload field | Required | Description |
|---|---|---|
message |
Yes | Message body to publish |
Connector Configuration#
The connector is created with type: "cloud", provider: "aws", service_type: "sns", plus:
Field (config) |
Required | Description |
|---|---|---|
region |
No | AWS region code. Derived automatically from topic_arn if a full ARN is supplied. |
access_key |
Yes | AWS access key. |
secret_key |
Yes | AWS secret key. |
topic_arn |
Yes | SNS topic ARN |
Output#
json
{
"status": "completed",
"statusCode": 200,
"data": {
"status": "published",
"statusCode": 200,
"method": "SNS_PUBLISH",
"endpoint": "arn:aws:sns:us-east-1:123456789:my-topic",
"duration": 38,
"response": { "topic_arn": "arn:aws:sns:us-east-1:123456789:my-topic" }
}
}
Example#
Connector config (API key):
json
{
"type": "cloud",
"provider": "aws",
"service_type": "sns",
"access_key": "${secrets.aws_access_key}",
"secret_key": "${secrets.aws_secret_key}",
"topic_arn": "arn:aws:sns:us-east-1:123456789:alerts"
}
Tendrl