Twilio Connector Setup Guide
Last updated: June 9, 2026
How to connect your Twilio account to Hadrius for SMS archiving.
What You Need
To connect Twilio, you will need three pieces of information from your Twilio account:
Credential | What It Is | Looks Like |
|---|---|---|
Account SID | Your Twilio account identifier. Think of it like a username for your account. |
|
API Key SID | An identifier for a specific API key you create. This is used alongside the API Key Secret to authenticate. |
|
API Key Secret | The password paired with your API Key SID. This is shown only once when you create the key — save it immediately. | A long alphanumeric string |
Step-by-Step: Where to Find Each Credential
1. Get Your Account SID
Log in to the Twilio Console at twilio.com/console
Your Account SID is displayed right on the main dashboard under Account Info
Click the copy icon next to it to copy the value
💡The Account SID is not a secret — it identifies your account but cannot be used alone to authenticate. It always starts with AC.
2. Create an API Key (to get the API Key SID and API Key Secret)
Twilio recommends using API Keys instead of your Auth Token for integrations. Here’s how to create one:
Log in to the Twilio Console at twilio.com/console
In the left sidebar, click Account → API keys & tokens
Alternatively, go directly to twilio.com/console/project/api-keys
Click the Create API Key button
Give the key a Friendly Name (e.g., "Hadrius Compliance Archiving")
Set the Key type to Standard
Click Create API Key
⚠ Important: On the next screen, Twilio will show you both the SID and the Secret. The Secret is displayed only once. Copy both values immediately and store them securely. If you lose the Secret, you will need to create a new API Key.
Copy the SID — this is your API Key SID (starts with SK)
Copy the Secret — this is your API Key Secret
Click Done
What Permissions Are Needed?
The API Key needs access to read SMS messages from the account. A Standard key type provides the necessary permissions. You do not need a Main or Master key.
Specifically, Hadrius uses these permissions:
Read incoming phone numbers — to know which numbers to monitor
Read SMS messages — to archive text message content
Read media attachments — to archive MMS images and files
🔒Hadrius uses read-only access. It does not send messages, modify phone numbers, or make any changes to your Twilio account.
Handing Off the Credentials
Once you have all three values, send them securely to your Hadrius onboarding contact:
Account SID —
ACxxxxxxxx...API Key SID —
SKxxxxxxxx...API Key Secret — the secret string
⚠Do not send credentials over email or Slack in plain text. Use a secure sharing method (e.g., a password manager sharing feature, an encrypted channel, or whatever your firm’s security policy specifies).
Revoking Access
If you ever need to disconnect Hadrius from Twilio:
Go to Account → API keys & tokens in the Twilio Console
Find the API key you created (by its friendly name)
Click Delete to revoke it
This immediately stops Hadrius from accessing your Twilio account. No data in Twilio is affected.
FAQ
1⃣ What is the difference between the Auth Token and an API Key?
Your Auth Token is shown on the Twilio dashboard and has full account access. API Keys are more secure because they can be individually revoked without affecting other integrations. We require an API Key instead of the Auth Token.
2⃣ I lost my API Key Secret. What do I do?
You cannot recover a lost Secret. Go to Account → API keys & tokens, delete the old key, and create a new one. Then provide the new credentials to your Hadrius contact.
3⃣ Does this work with Twilio subaccounts?
Yes. Use the subaccount’s Account SID and create the API key within that subaccount. Each subaccount needs its own set of credentials.
4⃣ What data does Hadrius pull from Twilio?
Hadrius archives SMS and MMS messages (text content and media attachments) sent and received by your Twilio phone numbers. It does not access call logs, voicemails, or any other Twilio products.