Twilio may suspend your use of the Services if you or one of your end users breaks the Acceptable Use Policy (for example spam or phishing). [7]
Guides · messaging · Verification-gated
Twilio account, upgrade and API keys
Create a Twilio account, upgrade it from trial to paid, and create an API key (SID + secret) for server-side calls. Almost every other Twilio product (Verify, WhatsApp, toll-free, A2P 10DLC) starts here.
Researched · not yet run liveLast researched 25 October 2026 · Twilio · provider site
Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.
Who owns what
One Twilio login (user) can belong to one or more Twilio accounts. Each account has an Account SID (AC…) and a primary Auth Token, and can hold subaccounts. API keys (SK…) live inside an account and, like Auth Tokens, are valid only in the Twilio Region where they were created.
- Twilio user login personal owned by the personEmail and personal phone number are verified at sign-up.
- Twilio account (AC…) organisation owned by the person or the company · under Twilio user loginStarts as a trial; must be upgraded (paid) for most production messaging.
- Subaccount projectoptional · under Twilio account (AC…)Optional; each has its own SID and Auth Token that must be rotated separately.
Main keys equal Account SID + Auth Token access; Standard keys cannot manage Accounts or Keys; Restricted keys are fine-grained.
Credentials made in one Twilio Region fail authentication in another.
Have ready
- An email address and a personal mobile phone that can receive SMS: Both are verified during sign-up.
- A personal mobile phone you control · Sign-up verifies a personal phone number, and paid accounts must use 2FA at login. [3]Needed for: Create a Twilio account, Upgrade from trial
- A card for the starting balance · Upgrading asks for an address, a starting balance and payment details. [3]Needed for: Upgrade from trial
- Your (or your business) address as you want it on the account profile · The upgrade flow asks you to create a profile and add an address. [3]Needed for: Upgrade from trial
Steps
Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.
Create a Twilio account
You sign up yourself at twilio.com, then verify your email address and a personal phone number. verapli never creates the account for you.
- The provider says
- Trial starts immediately after email and phone verification; trial expires 30 days after sign-up. [3]
- Your time
- about 5 min
If something goes wrong (1)
- A trial message or call fails to reach a number: On trial you can only reach verified recipients (up to 5, in your sign-up country). Verify the recipient in the Console or upgrade. [3]
Where: https://www.twilio.com/try-twilio
Turn on two-step verification
Set up 2FA for your Twilio login. It is enforced on paid accounts, so do it before upgrading.
Upgrade from trial
Click Upgrade in the Console, create a profile, add an address, choose a starting balance and enter payment details. You enter the card yourself.
- The provider says
- No review time stated; upgrade is completed in the Console. [3]
- Your time
- about 10 min
Where: https://console.twilio.com/
Pick the Twilio Region for your keys
Select the Region you will send traffic in before creating the key; keys only work in the Region where they were made.
Create a Standard API key
In Console, open API keys & tokens and create a key. Choose Standard (or Restricted) unless you really need Main. The secret is shown once only; verapli captures it straight into your vault.
verapli captures
TWILIO_API_KEY_SECREThere by plain code: encrypted in your browser, never shown to AI.If something goes wrong (2)
- The key secret was lost or not copied: The secret cannot be shown again. Create a new key, update your app, then (yourself) delete the old key from its details page. [2]
- Requests fail with authentication errors although the key is correct: Check the key was made in the same Twilio Region your code calls; credentials are Region-specific. [2]
Where: https://console.twilio.com/
Note your Account SID
Copy the Account SID (AC…) from the Console dashboard; it is not secret but every API call needs it.
verapli captures
TWILIO_ACCOUNT_SIDhere by plain code: encrypted in your browser, never shown to AI.Where: https://console.twilio.com/
Terms and gotchas
Plain-English summary, not legal advice. Each card links its source.
Twilio may temporarily suspend accounts for sudden traffic spikes, suspected compromise or overdue balances; contact Support within 24 hours to start reactivation. [6]
A Main API key has the same power as your Account SID and Auth Token; prefer Standard or Restricted keys. [1]
Promoting a secondary Auth Token instantly deletes the old primary token; update your apps first. [4]
What you end up with
| Env var | Secret | Format | What it is |
|---|---|---|---|
TWILIO_ACCOUNT_SID | not secret | AC… (34 characters) | Twilio Account SID |
TWILIO_API_KEY_SID | not secret | SK… (34 characters) | API key SID (used as the username with the secret) |
TWILIO_API_KEY_SECRET | secret | API key secret, shown once at creation |
Renewals
- Trial account expiry (upgrade or lose the trial): every 30 days after sign-up (once) [3]
Pricing
- Free tier: Trial with product-specific free units (examples given include 100 SMS and 75 voice minutes), 30 days.
- Costs: Pay as you go from a prepaid balance after upgrade.
- Upgrading gives eligible products a fresh set of post-upgrade free units before usage is charged.
Source [3]
For agents
The same entry as JSON: /api/v1/entries/twilio/account-and-keys · requirements /api/v1/requirements/twilio/account-and-keys · terms /api/v1/terms/twilio/account-and-keys.
Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp
> "What do I need for Twilio account, upgrade and API keys, and how long will it take?"
→ tools/call requirements { "provider_id": "twilio/account-and-keys" }Sources
- Twilio docs – API keys overview Key types (Main, Standard, Restricted); Main only creatable in Console; Main equals Account SID + Auth Token access; API keys are the preferred auth method; credentials are Region-specific · accessed 25 October 2026 · official
- Twilio docs – Manage regional API credentials API key secret is displayed only once at creation; select Region before creating a key; credentials only valid in the Region where created · accessed 25 October 2026 · official
- Twilio docs – How to use your free trial account Sign-up verifies email and a personal phone number; trial limits (5 verified recipients, sign-up country only, templates only, 30-day expiry, free units); upgrade steps (profile, address, starting balance, payment details); A2P 10DLC needs a paid account · accessed 25 October 2026 · official
- Twilio docs – Auth Token resource (secondary token and promote) Auth Token can be rotated in Console or API; secondary token can be created and promoted, which deletes the old primary · accessed 25 October 2026 · official
- Twilio blog – Mandatory two-factor authentication for account login Twilio enforces 2FA at login for paid accounts (from 12 October 2020); trial accounts excluded · accessed 25 October 2026 · official
- Twilio docs – Fraud response guide, engage Twilio Support Twilio may suspend accounts for AUP violations, unusual usage spikes, suspected compromise or unpaid balances; contact Support within 24 hours to start review · accessed 25 October 2026 · official
- Twilio Acceptable Use Policy Twilio may suspend use of the Services if the customer or an end user violates the AUP · accessed 25 October 2026 · official
Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. Twilio is not affiliated with verapli.