Import an existing SNS topic

When deploying to your own cloud, the Encore platform provisions the infrastructure backing your Pub/Sub topics automatically. If you already have an AWS SNS topic, you can instead connect an Encore Pub/Sub topic directly to that existing topic.

Benefits

Using an existing SNS topic allows you to:

• Reuse a topic that is shared with systems outside of Encore
• Preserve existing configuration and access policies
• Point Encore at a topic you already manage

Prerequisites

• A connected AWS account on the environment.
• The Encore IAM role must have permission to access the SNS topic you want to import.
• A Pub/Sub topic declared in your application:

import { Topic } from "encore.dev/pubsub";

export const signups = new Topic<SignupEvent>("signups", {
  deliveryGuarantee: "at-least-once",
});

var Signups = pubsub.NewTopic[*SignupEvent]("signups", pubsub.TopicConfig{
	DeliveryGuarantee: pubsub.AtLeastOnce,
})

Importing an SNS topic

1. Open the Infrastructure page for your environment in the Encore platform dashboard.
2. Locate the Pub/Sub topic you want to connect and click Import.
3. In the dialog:
   • Select the AWS Account that owns the topic.
   • Enter the Topic ARN in the form arn:aws:sns:<region>:<account>:<topic>.
4. Click Import.

The account ID in the ARN must match the account ID of the selected AWS integration.

Importing creates a proposed infrastructure change. Review it in the pending changes summary and click Deploy to apply it. On the next deploy, the Encore platform switches your Pub/Sub topic to the existing SNS topic, replacing the topic it previously provisioned.