Home / Docs / Getting Started / Connecting Your Twilio Account
Connecting Twilio is a one-time setup: give TelBuddy the two credentials it needs to talk to your account, then sync your numbers in.
Where to find your credentials. Log into your own Twilio Console and look at the dashboard homepage — your Account SID and Auth Token are both displayed there. These two values are how TelBuddy authenticates as your account when it reads your numbers and configures their webhooks; they are not a username/password and don't grant TelBuddy any access beyond your Twilio account's own API.
Where to enter them in TelBuddy. Go to System Management → Phone Numbers → API Keys tab, paste in the Account SID and Auth Token, and save.
What the Sync from Twilio button actually does. It reads your Twilio account and lists the phone numbers already there — it does not move, port, or repurchase anything. Once a number shows up in TelBuddy's list, TelBuddy automatically points that number's SMS and voice webhooks at TelBuddy's own endpoints. That single step is what makes inbound texts land in the shared inbox and inbound calls reach your IVR menu, forwarding rules, or AI receptionist.
If a number is already attached to a Messaging Service. TelBuddy updates that Messaging Service's webhook so the change applies correctly — it does not create a new Messaging Service or attach the number to a different one on its own. If you manage Messaging Services directly in Twilio for other reasons, this is worth knowing before you sync.
Keeping credentials current. If you ever rotate your Auth Token in Twilio (a normal security practice), come back to the same API Keys tab and update it — TelBuddy's connection breaks silently otherwise, so it's worth re-checking here first if numbers stop syncing or webhooks stop firing.