Coming soon. Export to Amazon Connect is on the way
In this article, you can find more information on exporting email templates from Stripo to Amazon Connect.
To export your email template from Stripo directly to Amazon Connect, you need to:
Open an email template and click the "Export" button, which is located above the email template, then click on Email Provider and find the "Amazon Connect" icon;
[screenshot: Export → Email Provider → Amazon Connect]
Next, pick an authentication method, either access keys or an IAM role.
Important to note. Before the first export, open Content management → Message templates in your Amazon Connect admin website at least once. Amazon Connect creates the template storage for your instance only after this, and Stripo won't be able to export templates to the instance until then.
Authentication with access keys:
Enter your Export account name (you can use any name), API Key, Secret Key, and select your AWS region from the drop-down list;
[screenshot: Step 1 — Access keys]
You will find the API Key and Secret in your Amazon account. Please refer to the Access Keys documentation in the AWS General Reference.
Stripo supports the following regions for Amazon Connect: us-east-1, us-west-2, ca-central-1, eu-west-2, eu-central-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, ap-northeast-2, af-south-1. Select the region where your Amazon Connect instance is located.
Next, select your Amazon Connect instance from the drop-down list and click the "Export" button. The list shows only active instances in the selected region. You will find the instance name (alias) in the URL of your Amazon Connect admin website, for example, https://your-instance-name.my.connect.aws.
[screenshot: Step 2 — Instance]
Important to note. To be able to export email templates to Amazon Connect, your Amazon account should have at least 5 permissions:
connect:ListInstances;connect:ListIntegrationAssociations;wisdom:CreateMessageTemplate;wisdom:UpdateMessageTemplate;wisdom:GetMessageTemplate.
Authentication with an IAM role:
If your security team requires using IAM roles instead of access keys, Stripo supports this. Most of the technical work is done by your AWS administrator — your job is to coordinate the handoff between Stripo and your admin.
How to set it up?
Choose "IAM Role" as an authentication method for your account;
Stripo will display your External ID, a unique value generated for your connection. Copy it.
Send your admin:
The External ID from step 2
A link to this guide (it contains our Stripo Role ARN and the JSON policies they'll need)
Wait for your admin to send back a Role ARN (it looks like
arn:aws:iam::123456789:role/StripoAccessRole) and the AWS region of your Amazon Connect instance.Paste the Role ARN into Stripo and select your AWS Region.
Select your Amazon Connect instance and click Export.
That's it. You can now export templates to your Amazon Connect instance.
💡 Tip: You can save your progress and come back later if your admin needs time to set things up. Your External ID stays the same — no need to start over.
For AWS administrators:
If you're the AWS administrator setting up this connection, here's everything you need. The marketer in your organization will provide you with an External ID generated by Stripo, which you'll use in the trust policy below.
Step 1. Create an IAM role
In your AWS account, create a new IAM role. Any name works — for example, StripoAccessRole.
Step 2. Attach the trust policy
Replace <EXTERNAL_ID> with the value provided by the marketer.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::214147298139:role/stripe-ses-iam-export-service-live"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"sts:ExternalId": "<EXTERNAL_ID>"
}
}
}
]
}Step 3. Attach the permissions policy
This grants Stripo the minimum permissions needed to find your Amazon Connect instances and manage message templates.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"connect:ListInstances",
"connect:ListIntegrationAssociations",
"wisdom:CreateMessageTemplate",
"wisdom:UpdateMessageTemplate",
"wisdom:GetMessageTemplate"
],
"Resource": "*"
}
]
}Step 4. Enable message templates in the instance
Make sure Content management → Message templates has been opened at least once in the Amazon Connect admin website of the instance the marketer plans to use. If you use the af-south-1 region, make sure this region is enabled in your AWS account.
Step 5. Share the Role ARN and Region
Send the ARN of the newly created role back to the marketer along with the AWS region of your Amazon Connect instance, so they can paste it into Stripo.
FAQ for IAM Role connection:
Why use IAM role instead of access keys?
Your admin doesn't need to generate or share long-lived secrets with Stripo. Instead, Stripo gets temporary access that renews automatically, which is what most enterprise security policies require.
Can I switch from access keys to an IAM role later?
Yes. Your existing access key connection continues to work, and you can create a new IAM role connection alongside it.
Your email template will be delivered to the "Content management" → "Message templates" menu of the selected instance;
To find your template, you should open your Amazon Connect admin website (https://your-instance-name.my.connect.aws) and go to "Content management" → "Message templates";
[screenshot: Message templates list in Amazon Connect]
Important to note. Stripo exports the email template as a draft. The email subject becomes the template subject; if the email has no subject, the email name is used instead. Before agents and campaigns can use the template, save it as a version and activate it in Amazon Connect.
If you export the template more than once, you will see the following pop-up notification, where you are asked to choose whether you'd like to export your newsletter as a new one or replace an existing one (the GetMessageTemplate permission required). When you replace an existing one, Stripo updates the HTML and the subject of the same template draft; other template settings in Amazon Connect stay unchanged. If the template was deleted in Amazon Connect, the option to replace it isn't available.
[screenshot: re-export pop-up]
In addition, we added the ability to change the email template's name when re-exporting. To do this, you need to re-export the email by clicking on "As a new one", and after that, you will have the opportunity to change its name. The new name must be unique within the instance.
[screenshot: rename on re-export]
Troubleshooting part:
If during the export process, you have received the error Status Code: 400; Error Code: ValidationException; "Invalid message template content.", as in the screenshot:
[screenshot: error toast]
Please, try to double-check that all dynamic tags in your email template and its subject are closed. Amazon Connect reads everything inside {{ }} as dynamic content, so a single unclosed {{ breaks the export. Amazon Connect uses tags like {{Attributes.Customer.FirstName}}.
Other errors you may see:
Error Code: ConflictException — a template with the same name already exists in the instance. Rename the email and export it again, or choose "As a new one" with a new name.
Error Code: UnrecognizedClientException — the API Key is incorrect, or you use the
af-south-1region and it isn't enabled in your AWS account.Error Code: InvalidSignatureException — the Secret Key is incorrect.
Error Code: AccessDeniedException — your AWS account or IAM role doesn't have one of the required permissions. The error text names the missing permission.
Error Code: ServiceQuotaExceededException — the instance already has 200 message templates, the Amazon Connect limit. Delete unused templates in Amazon Connect and export again.
Thank you for taking the time to read our articles. We hope this information is helpful.
If you have any additional questions, please email us at support@stripo.email.
We would be glad to talk with you.
