The steps to reconnect Amazon Connect depend on how your AWS account is set up: the IAM role Assembled uses, your region and instance, and how your contact records and agent events are streamed. Because of that, please contact Support before you change anything, so we can confirm the right steps for your account.
If you're here because of the November 13, 2026 security incident: Contact Support before you reconnect. We'll work with your AWS admin on a plan for your account. For more about the incident, see November 13, 2026 security incident.
Who does this
- An Assembled admin, or someone with a role that can configure third-party integrations.
- An AWS admin who knows your original Amazon Connect setup: the IAM role, region, instance, and data streaming. Ideally, this is the person who set up the integration.
Before you start
- Contact Support and tell us which AWS regions and Amazon Connect instances you use with Assembled. Don't send access keys or secrets.
- Have these details ready: your AWS account ID, region, Amazon Connect instance ARN, and how your contact trace records (CTRs) and agent events are streamed (Kinesis stream or S3 bucket), including any custom folder prefixes.
Steps
- In Assembled, go to Configure > Third-party integrations and find the Amazon Connect card. If it still shows Connected, don't select Remove, because that deletes your saved configuration. Let Support know, and we'll clear the old connection without deleting your settings.
- With Support, have your AWS admin identify the IAM role Assembled uses, its trust settings, and any older Assembled access keys or sessions that need to be retired.
-
Once Support confirms a standard reconnect is right for your account, go to Configure > Third-party integrations > Amazon Connect and reconnect using your existing AWS configuration and the external ID shown in Assembled. Choose the streaming options that match your current setup.
- Check that the Amazon Connect card shows new contact and agent state syncs.
How to confirm it's working
- On the Amazon Connect card, check for recent successful contact and agent state syncs. The Connected tag on its own doesn't confirm that data is flowing.
- Compare recent contacts and agent states in Assembled with what you see in Amazon Connect.
- If a sync row is red, hover over it to see the error, and send that error text to Support.
When you'll see data
Once your role, streams, bucket, and any custom CTR folder prefixes are set up correctly, Assembled checks for new contact files about every 15 seconds and for agent states about every 30 seconds. After you reconnect, allow time for the next scheduled sync. Reports can take a little longer to refresh.
Restoring missed data
Reconnecting Amazon Connect doesn't automatically fill in the time it was disconnected. Contact Support with the dates affected, plus any custom CTR folder prefixes, and we'll help recover contact records for that gap. Agent state history can only be recovered while it's still within your stream's retention period, so let us know as soon as you can.
For older contact history, see Historical Amazon Connect contact data. Export one CSV for each AWS region, and end the export before streaming started so contacts aren't counted twice.
Things to watch for
- Contact Support first. We'll confirm the right steps for your AWS setup before you change any credentials.
- Don't select Remove on a connected Amazon Connect card. It deletes your saved configuration.
- Don't create new streams or rerun the CloudFormation template unless Support asks you to. Reconnect with your existing streaming setup.
- Keep your role's trust settings. If the external ID blocks reconnecting, contact Support rather than loosening the role's trust policy.
- Check your CTR folder prefixes. If you use custom prefixes, confirm they're still set after reconnecting.
- Ask about missed data soon. Agent state history can't be recovered once it's past your stream's retention period.
For more about how the integration works, see Amazon Connect integration.
Need help?
If something doesn't look right, contact our Support team and include any error text you see on the Amazon Connect card. Please don't send AWS access keys or secrets by email or chat.