To replace the Twilio credential Assembled uses to connect to your Twilio account, you create a new one in Twilio, and our Support team helps you update it in Assembled. How it's updated depends on how your connection was set up, so please contact Support before you change anything.
If you're here because of the November 13, 2026 security incident: We're asking customers to replace the credentials for every integration connected to Assembled, including Twilio. Pausing or disconnecting the integration in Assembled doesn't stop the old credential from working. Only retiring it in Twilio does. 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.
- A Twilio admin who can create and delete Auth Tokens or API keys for the account Assembled connects to.
Before you start
- Contact Support and tell us you're ready to replace your Twilio credential. We'll confirm which Twilio account or subaccount Assembled connects to, and whether it uses an Auth Token or an API key.
- Note any Twilio settings you've set up in Assembled, such as queue rules and agent state mappings, so you can check them afterward.
Steps
- Contact Support first, as described above. Don't change the integration in Assembled before we've confirmed the update path for your account.
- In Twilio, have your admin create a new credential of the type Support confirmed (Auth Token or API key) for that account. Don't delete the old one yet.
- Work with Support to update the credential in Assembled. Please don't send the new credential by email or chat; we'll tell you how to enter it securely.
- Once Support confirms Assembled is syncing with the new credential, have your Twilio admin delete or retire the old one.
If a step doesn't match what you see, or you can't finish it, contact Support. We're working through these with customers individually and will help you finish reconnecting.
How to confirm it's working
- The sync rows on the Twilio card in Configure > Third-party integrations are green and show a recent successful sync. The Connected tag on its own doesn't confirm that data is flowing.
- Recent contacts and agent states appear in Assembled.
- The old credential no longer appears as active in Twilio.
When you'll see data
Assembled checks Twilio for new contacts and agent states about every 30 seconds. After the credential is updated, allow time for the next scheduled sync. Reports can take a little longer to refresh.
Restoring missed data
If you see gaps from while Twilio wasn't syncing, contact Support and let us know which dates are affected. We'll check your settings before restoring any history, so the restored data uses the right configuration.
Things to watch for
- Contact Support before changing anything. The update path depends on how your Twilio connection was set up.
- Don't remove or re-create the Twilio integration in Assembled. Removing it can delete your saved settings.
- Create the new credential first. Delete the old one only after Support confirms the new one is working, so syncing isn't interrupted.
- Retire the old credential in Twilio. Updating Assembled doesn't make the old one stop working.
Need help?
If something doesn't look right, contact our Support team and include any error text you see on the Twilio card. Please don't send tokens, API keys or passwords by email or chat.