Only show these results:

Amazon SNS

Amazon Simple Notification Service (Amazon SNS) is a managed messaging service that supports pub/sub messaging and mobile push notifications.

You’ll learn how to add Amazon SNS as a Nylas Stream.

Prerequisites

Create a New Connector

Set up tip

Keep your dashboard open because you'll be frequently referring to the information there.

  1. Go to the Nylas dashboard and select Streams.
  2. Select Amazon SNS.
  3. Choose your data source.
  4. Keep your dashboard open, we'll move onto the next steps and let you know when you need to refer to the dashboard and when to enter information.

Create SNS Topic

  1. Go through the steps in Creating an Amazon SNS topic.
    1. We recommend topic type to be Standard.
  2. Keep your Topic ARN ready, you’ll need this in Create IAM Role.
  3. Copy the Topic ARN into your dashboard into Destination ARN.
Image of Amazon SNS Topic ARN page.

Create an S3 Bucket (Optional)

Create an S3 bucket to stream data that is larger than 256 KB. By default, the AWS SNS Connector will skip publishing data objects larger than 256 KB.

  1. Go to Amazon S3 and create a new bucket.
  2. Select the bucket and click Copy ARN.
  3. Copy the ARN into the dashboard and save the S3 ARN for Create IAM Role.
Image showing Amazon console with Topic screen

Create IAM Role

You’ll need to create an IAM Role that gives Nylas access to write to your SNS topic and your S3 bucket. You’ll be creating a new role and policy.

  1. Go to IAM.

  2. Go to Access management > Roles.

  3. Select Another AWS account.

    1. Account ID - 925176737378
    2. Select Require external ID (Best practice when a third party will assume this role)
    3. In your dashboard, copy the External ID and add it as the External ID into AWS console.
    Image showing Amazon console create a new role screen
  4. On the next screen, click Create policy. This will open a new window or tab. You’ll need to keep both the Create role and Create policy windows open.

  5. Select JSON. Depending on if you are using S3 or not, copy the JSON for your policy. Modify the highlighted items with <YOUR-TOPIC-ARN> and <YOUR-S3-BUCKET-ARN>.


    {
    "Version": "2012-10-17",
    "Statement": [
    {
    "Sid": "VisualEditor0",
    "Effect": "Allow",
    "Action": "sns:Publish",
    "Resource": "<YOUR-TOPIC-ARN>"
    }
    ]
    }
    {
    "Version": "2012-10-17",
    "Statement": [{
    "Sid": "VisualEditor0",
    "Effect": "Allow",
    "Action": [
    "s3:*Object*",
    "sns:Publish"
    ],
    "Resource": [
    "<YOUR-S3-BUCKET-ARN>/*",
    "<YOUR-TOPIC-ARN>"
    ]
    }]
    }
  6. Name the policy nylas-streams-write-policy and save.

  7. Go back to the Create role window and click refresh.

  8. Search for nylas-streams-write-policy and select the policy.

  9. Name the role nylas-streams-write-role and create the role.

  10. Copy the role ARN, and add it your dashboard in IAM Role ARN.

  11. You can save your Nylas Stream.

Activate Your Stream

  1. Go to your Streams and click the Activate button next to the new Stream.
  2. Once connected, the status will update to Activated.
Nylas dashboard, click the button to active the stream.

Create an Integration

You can skip this step, if you have already created an Integration.

Before beginning the steps here, make sure you have created an app for the Integration. You’ll need the client ID and client secret.

  • Google
    • With the redirect URI added https://datastreams.us.nylas.com/connect/callback.
  • Azure
    • With the redirect URI added https://datastreams.us.nylas.com/connect/callback
  1. Go to the Nylas dashboard and select Integration.
  2. Choose the Integration you want to create.
  3. Enter the client ID, client secret, and redirect URI.

Create a Grant

You’ll need to grant an email access to the Integration you created.a

  1. Go to the Nylas dashboard and select Grants.
  2. Click Add Grant.
  3. Enter the email address you want to grant.

You’ll need to create a grant for each email you want to get data for.

Test Your Integration

To test for receiving data, setup a subscription in AWS that's listening to the configured SNS topic. View the link below for more about the Amazon configuration.

The sections below detail pulling new messages using SQS.

Poll for New Messages

  1. Go to SQS and select the queue you created for your Stream.
  2. Click Poll for messages
Poll for new messages in SQS

Message

If you selected message.create as your data source, create a new email message.

Grants

If you selected grants as your data source, you’ll get notifications when a grant expires or when an account is granted access to an Integration.