awsclaw-sns

name	awsclaw-sns
description	Manage Amazon SNS topics, subscriptions, publishing, platform applications, SMS, and endpoints using awsclaw. Create, configure, and delete resources, publish messages, and check SMS/sandbox status.

Awsclaw SNS

Manage SNS topics, subscriptions, publishing, platform applications, and SMS.

When to Use This Skill

Use this skill when the user:

• Asks about SNS topics or notifications
• Wants to publish messages to a topic
• Needs to inspect subscriptions or endpoints
• Asks about SMS, platform applications, or push notifications
• Wants to check data protection policies or sandbox status
• Wants to create or delete topics, subscriptions, or endpoints
• Needs to configure topic or subscription attributes

Tool: SNSTool

Execute AWS SNS commands. ALWAYS provide params object.

Commands

ListTopics

List all SNS topics.

{ "command": "ListTopics", "params": {} }

Parameters:

Parameter	Type	Required	Description
NextToken	string	No	Pagination token

GetTopicAttributes

Get attributes of a topic (policy, subscriptions count, etc.).

{ "command": "GetTopicAttributes", "params": { "TopicArn": "arn:aws:sns:us-east-1:123456789012:my-topic" } }

Parameters:

Parameter	Type	Required	Description
TopicArn	string	Yes	Topic ARN

Publish

Publish a message to a topic.

{ "command": "Publish", "params": { "TopicArn": "arn:aws:sns:...", "Message": "Hello World", "Subject": "Test" } }

Parameters:

Parameter	Type	Required	Description
TopicArn	string	Yes	Topic ARN
Message	string	Yes	Message body
Subject	string	No	Message subject (for email subscriptions)
TargetArn	string	No	Target ARN (for direct publishing)
phoneNumber	string	No	E.164 phone number (for SMS)
MessageStructure	string	No	Message structure (set to json for per-protocol messages)
MessageAttributes	object	No	Custom message attributes

ListSubscriptions

List all subscriptions across topics.

{ "command": "ListSubscriptions", "params": {} }

Parameters:

Parameter	Type	Required	Description
NextToken	string	No	Pagination token

ListSubscriptionsByTopic

List subscriptions for a specific topic.

{ "command": "ListSubscriptionsByTopic", "params": { "TopicArn": "arn:aws:sns:..." } }

Parameters:

Parameter	Type	Required	Description
TopicArn	string	Yes	Topic ARN
NextToken	string	No	Pagination token

GetSubscriptionAttributes

Get attributes of a subscription.

{ "command": "GetSubscriptionAttributes", "params": { "SubscriptionArn": "arn:aws:sns:..." } }

Parameters:

Parameter	Type	Required	Description
SubscriptionArn	string	Yes	Subscription ARN

ListTagsForResource

List tags for an SNS resource.

{ "command": "ListTagsForResource", "params": { "ResourceArn": "arn:aws:sns:..." } }

Parameters:

Parameter	Type	Required	Description
ResourceArn	string	Yes	Resource ARN

ListPlatformApplications

List push notification platform applications.

{ "command": "ListPlatformApplications", "params": {} }

Parameters:

Parameter	Type	Required	Description
NextToken	string	No	Pagination token

GetPlatformApplicationAttributes

Get attributes of a platform application.

{ "command": "GetPlatformApplicationAttributes", "params": { "PlatformApplicationArn": "arn:aws:sns:..." } }

Parameters:

Parameter	Type	Required	Description
PlatformApplicationArn	string	Yes	Platform application ARN

ListEndpointsByPlatformApplication

List endpoints for a platform application.

{ "command": "ListEndpointsByPlatformApplication", "params": { "PlatformApplicationArn": "arn:aws:sns:..." } }

Parameters:

Parameter	Type	Required	Description
PlatformApplicationArn	string	Yes	Platform application ARN

GetEndpointAttributes

Get attributes of an endpoint.

{ "command": "GetEndpointAttributes", "params": { "EndpointArn": "arn:aws:sns:..." } }

Parameters:

Parameter	Type	Required	Description
EndpointArn	string	Yes	Endpoint ARN

GetSMSAttributes

Get SMS sending attributes.

{ "command": "GetSMSAttributes", "params": { "attributes": ["DefaultSMSType", "MonthlySpendLimit"] } }

Parameters:

Parameter	Type	Required	Description
attributes	array of strings	No	Specific SMS attribute names to retrieve

GetSMSSandboxAccountStatus

Check if the account is in SMS sandbox.

{ "command": "GetSMSSandboxAccountStatus", "params": {} }

Parameters: None required.

GetDataProtectionPolicy

Get data protection policy for a topic.

{ "command": "GetDataProtectionPolicy", "params": { "ResourceArn": "arn:aws:sns:..." } }

Parameters:

Parameter	Type	Required	Description
ResourceArn	string	Yes	Resource ARN

CheckIfPhoneNumberIsOptedOut

Check if a phone number has opted out.

{ "command": "CheckIfPhoneNumberIsOptedOut", "params": { "phoneNumber": "[phone]" } }

Parameters:

Parameter	Type	Required	Description
phoneNumber	string	Yes	E.164 phone number

ListPhoneNumbersOptedOut

List phone numbers that have opted out.

{ "command": "ListPhoneNumbersOptedOut", "params": {} }

ListOriginationNumbers

List origination phone numbers.

{ "command": "ListOriginationNumbers", "params": {} }

Lifecycle Commands

CreateTopic

Create a new topic.

{ "command": "CreateTopic", "params": { "Name": "alerts" } }

Subscribe

Subscribe an endpoint to a topic.

{ "command": "Subscribe", "params": { "TopicArn": "arn:aws:sns:...:alerts", "Protocol": "email", "Endpoint": "[e-mail]" } }

ConfirmSubscription

Confirm a subscription (for token-based subscriptions).

{ "command": "ConfirmSubscription", "params": { "TopicArn": "arn:aws:sns:...:alerts", "Token": "token" } }

Unsubscribe

Unsubscribe an endpoint.

{ "command": "Unsubscribe", "params": { "SubscriptionArn": "arn:aws:sns:..." } }

SetTopicAttributes

Update topic attributes.

{ "command": "SetTopicAttributes", "params": { "TopicArn": "arn:aws:sns:...:alerts", "AttributeName": "DisplayName", "AttributeValue": "Alerts" } }

SetSubscriptionAttributes

Update subscription attributes.

{ "command": "SetSubscriptionAttributes", "params": { "SubscriptionArn": "arn:aws:sns:...", "AttributeName": "RawMessageDelivery", "AttributeValue": "true" } }

CreatePlatformApplication

Create a platform application.

{ "command": "CreatePlatformApplication", "params": { "Name": "mobile-app", "Platform": "APNS", "Attributes": { "PlatformCredential": "..." } } }

CreatePlatformEndpoint

Create a platform endpoint.

{ "command": "CreatePlatformEndpoint", "params": { "PlatformApplicationArn": "arn:aws:sns:...", "Token": "device-token" } }

DeleteTopic

Delete a topic.

{ "command": "DeleteTopic", "params": { "TopicArn": "arn:aws:sns:...:alerts" } }

DeletePlatformApplication

Delete a platform application.

{ "command": "DeletePlatformApplication", "params": { "PlatformApplicationArn": "arn:aws:sns:..." } }

DeleteEndpoint

Delete a platform endpoint.

{ "command": "DeleteEndpoint", "params": { "EndpointArn": "arn:aws:sns:..." } }

TagResource

Tag an SNS resource.

{ "command": "TagResource", "params": { "ResourceArn": "arn:aws:sns:...", "Tags": [{ "Key": "env", "Value": "prod" }] } }

UntagResource

Remove tags from an SNS resource.

{ "command": "UntagResource", "params": { "ResourceArn": "arn:aws:sns:...", "TagKeys": ["env"] } }

---

Related Services

• SNS → SQS: SNS topics commonly subscribe to SQS queues for fan-out. Use ListSubscriptionsByTopic to find SQS subscriptions, then SQSTool to inspect queues
• SNS → Lambda: SNS can trigger Lambda functions. Use ListSubscriptionsByTopic to find Lambda subscriptions
• SNS → S3: S3 event notifications can publish to SNS. Use S3Tool GetBucketNotificationConfiguration to find the topic
• SNS → CloudWatch: SNS delivery metrics are in CloudWatch Metrics
• SNS → CloudFormation: SNS resources managed by CloudFormation stacks