Amazon SNS destinations - Ampersand

For more information on destinations, see the Destinations page. When new data is read from a SaaS instance via a Read Action or Subscribe Action, Ampersand publishes the payload as messages to your Amazon SNS topic.

Prerequisites

Before setting up an SNS destination, ensure that you have:

An AWS account with an SNS topic
AWS credentials with sns:Publish permission on that topic

Data format

Ampersand publishes each read or subscribe message to your topic as JSON. The full payload schema is defined in webhook.yaml. Go to the Destinations page in the Ampersand Dashboard and create a new SNS destination. You’ll need to provide:

Field	Type	Required	Example	Description
Destination name	string	Yes	`ampersandSNS`	Alias to reference in your `amp.yaml` file
Topic ARN	string	Yes	`arn:aws:sns:us-east-1:123456789012:my-topic`	ARN of your SNS topic
Region	string	Yes	`us-west-2`	AWS region where your topic is located
AWS Access Key ID	string	Yes	`AKIAIOSFODNN7EXAMPLE`	AWS access key with `sns:Publish` permission
AWS Secret Access Key	string	Yes		AWS secret access key
Endpoint URL	string	No	`https://sns.us-east-1.amazonaws.com`	Custom SNS endpoint if applicable

Refer to the destination in your integration

After creating your SNS destination, reference it in your amp.yaml file:

specVersion: 1.0.0
integrations:
  - name: salesforceToSNS
    displayName: Salesforce to SNS
    provider: salesforce
    read:
      objects:
        - objectName: account
          destination: ampersandSNS
        - objectName: contact
          destination: ampersandSNS

⌘I