Twilio is one of two SMS providers Autocampaign AI
supports (the other is Telnyx). Connecting Twilio lets
Autocampaign AI send text messages from your Twilio numbers and receive replies in
your Inbox. It also manages A2P 10DLC
registration (the US carrier registration required to send business texts from a
local number) for you.
In short: 1) Paste your Twilio Account SID and Auth Token. 2) Register your
10DLC brand and pick a messaging service. 3) Add numbers and finish setup.
Only one SMS provider can be active at a time per workspace. If you already
have Telnyx connected, connecting Twilio will prompt you to switch — the previous
provider’s numbers and messaging services are removed on switch.
In Autocampaign AI, go to Settings → Channels. Under SMS, find the Twilio
card (“Enterprise SMS and MMS via Twilio”) and click Configure.
2
Enter your Twilio details
On the Connect tab, fill in:
Field
Where to find it
Format
Account SID
Twilio Console → Account Info
Starts with AC, 34 characters
Auth Token
Twilio Console → Account Info
32 characters (kept masked)
Autocampaign AI checks the format as you type — the Account SID must start with
AC and the Auth Token must be 32 characters.
3
Connect & save
Click Connect & Save Credentials. Autocampaign AI checks the details with
Twilio before saving. On success you’ll see
“Channel connected successfully” and the setup wizard opens automatically.
After connecting, the Set Up Your Channel wizard walks you through four steps
in the recommended order:
10DLC Brand
Register the business that will send messages. Click Register 10DLC Brand.
You can’t advance until a brand exists. See the full field list in
A2P 10DLC.
Service
Select one or more messaging services (the groups that hold your numbers),
or click Create Service and give it a name (for example, “My SMS Service”).
10DLC Campaign
Register a campaign linked to your service, or Skip to Numbers. A campaign
is strongly recommended so your business texts follow US carrier rules, but it
isn’t required to finish.
Numbers
Assign phone numbers to your messaging service, or Buy New Number.
Click Finish Setup to save. You can revisit any of these from the Service,
Numbers, and Brand & Campaign tabs on the Twilio channel page at any time.
In a hurry? Skip Setup selects every messaging service it finds so you can
send immediately. Come back to register 10DLC before you send at volume.
Webhooks are the addresses Twilio uses to
send replies and delivery updates to Autocampaign AI. You don’t set them up
yourself. When you finish setup, Autocampaign AI registers them with Twilio for each
messaging service:
Error — your login details were rejected or a connection check failed.
Each setup tab also shows a green check when complete or an amber warning when
something is still required (for example, “Brand registration required”).To disconnect, use Disconnect on the channel header. This makes all numbers
unusable and pauses active campaigns using the channel, so confirm carefully.
Both are on your Twilio Console dashboard under Account Info. The Account
SID starts with AC; the Auth Token is a 32-character secret you can reveal
and copy.
Can I use both Twilio and Telnyx at the same time?
No. Only one SMS provider is active per workspace. Connecting a second provider
prompts you to switch, which removes the first provider’s numbers and services
from Autocampaign AI.
Do I have to register 10DLC to send?
You can send with a connected channel, but US carriers require
A2P 10DLC registration for reliable delivery to US
mobile numbers. Register your brand and campaign before sending at volume.
Are my Twilio details stored securely?
Yes. They are stored encrypted. After saving, the Connect tab shows the
Account SID and a masked Auth Token only.
Can I change providers later?
Yes, but switching wipes the current provider’s numbers and messaging services
in Autocampaign AI. Your campaigns using that channel are paused until you set it
up again.
Twilio rejected the Account SID / Auth Token pair. Re-copy both from the Twilio
Console (watch for stray spaces at the end). Confirm the Auth Token is the
current one, not an old value that has since been replaced, then try again.
'Must be a valid Twilio Account SID (starts with AC)'
The SID field must be AC followed by 32 more characters (digits and the
letters a–f). You likely pasted an API Key SID (SK…) or a partial value — use
the Account SID from Account Info.
'Must be a 32-character auth token'
The Auth Token must be exactly 32 characters. Reveal and re-copy the full token.
Customer Profile / A2P Trust Product is not compliant
Your Twilio TrustHub profile isn’t approved yet. Complete Twilio’s business
profile verification in the Twilio Console, then retry brand registration.
See A2P 10DLC troubleshooting.
Why do messages send but replies don't appear?
Replies reach Autocampaign AI through webhooks. Finish the setup wizard so
Autocampaign AI can register its webhook addresses on your messaging service.
Also make sure the number is attached to a messaging service it manages.
Next: register for 10DLC
Required for reliable US SMS delivery.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Autocampaign AI","description":"Guides for SMS, email, WhatsApp, calls, CRM, campaigns, automation and AI Employees in Autocampaign AI.","colors":{"primary":"#4F46E5","light":"#818CF8","dark":"#4338CA"},"logo":{"light":"https://mintcdn.com/autocampaign/82V2y2PsfqbOwMED/images/favicon_512x512_png.png?fit=max\u0026auto=format\u0026n=82V2y2PsfqbOwMED\u0026q=85\u0026s=ce400247a470f7d0e11a6dff991c26e6","dark":"https://mintcdn.com/autocampaign/cN8tXm0NsZ0ToNZc/images/Autocampaign-Logo-transperant.png?fit=max\u0026auto=format\u0026n=cN8tXm0NsZ0ToNZc\u0026q=85\u0026s=f7dc612feaf44912e419b544dc512886","href":"https://docs.autocampaign.ai"},"favicon":{"light":"https://mintcdn.com/autocampaign/82V2y2PsfqbOwMED/images/favicon_512x512.svg?fit=max\u0026auto=format\u0026n=82V2y2PsfqbOwMED\u0026q=85\u0026s=e1edfc38b86692ec588d48387270a1e5","dark":"https://mintcdn.com/autocampaign/82V2y2PsfqbOwMED/images/logo_512x512.svg?fit=max\u0026auto=format\u0026n=82V2y2PsfqbOwMED\u0026q=85\u0026s=0c5e63634026962170c63053653cda44"},"background":{"color":{"light":"#FFFFFF","dark":"#0F172A"}},"navbar":{"links":[{"href":"mailto:support@autocampaign.ai","label":"Support"}],"primary":{"type":"button","label":"Open App","href":"https://app.autocampaign.ai"}},"footer":{"socials":{"website":"https://autocampaign.ai","github":"https://github.com/autocampaign-ai/mintlify-docs"}},"seo":{"metatags":{"og:site_name":"Autocampaign AI Help Center","og:type":"website","og:locale":"en_US","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"heading":{"family":"Space Grotesk","weight":700},"body":{"family":"Inter","weight":400}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"life-ring","href":"mailto:support@autocampaign.ai"},{"anchor":"Status","icon":"signal","href":"https://status.autocampaign.ai"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"autocampaign","hasAudioNarration":false,"actualSubdomain":"autocampaign","customDomains":["docs.autocampaign.ai"],"gitSource":{"type":"github","owner":"autocampaign-ai","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"b6ea518b-e7ad-4771-8f43-8f006abef72c","liveDeploymentHistoryId":"6aaf90ed14658ecdb9ab98b1","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aaf90ed14658ecdb9ab98b1"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aaf90ed14658ecdb9ab98b1","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Texting, email \u0026 WhatsApp","count":15},{"language":"default","tag":"Campaigns \u0026 automation","count":11},{"language":"default","tag":"Contacts \u0026 CRM","count":11},{"language":"default","tag":"Start here","count":9},{"language":"default","tag":"Reports \u0026 billing","count":8},{"language":"default","tag":"Reports","count":6},{"language":"default","tag":"For developers","count":6},{"language":"default","tag":"Send messages","count":5},{"language":"default","tag":"Channels","count":5},{"language":"default","tag":"Your contacts","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"providers/twilio","slug":"/providers/twilio","pageMetadata":{"title":"Connect Twilio","description":"Connect your Twilio account to send and receive SMS, then set up messaging services, numbers, and 10DLC.","icon":"plug","href":"/providers/twilio"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect your Twilio account to send and receive SMS, then set up messaging services, numbers, and 10DLC.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,Heading,Icon,Info,Note,Step,Steps,Table,Tip}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Icon)_missingMdxReference(`Icon`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Time to complete:`}),` ~15–30 minutes to connect and add numbers, plus 1–2 days for\n10DLC carrier approval \\xA0·\\xA0 `,_jsx(_components.strong,{children:`Difficulty:`}),` Beginner`]})}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsxs(_components.p,{children:[`Twilio is one of two SMS `,_jsx(_components.a,{href:`/getting-started/glossary#provider`,children:`providers`}),` Autocampaign AI\nsupports (the other is `,_jsx(_components.a,{href:`/providers/telnyx`,children:`Telnyx`}),`). Connecting Twilio lets\nAutocampaign AI send text messages from your Twilio numbers and receive replies in\nyour `,_jsx(_components.a,{href:`/inbox/overview`,children:`Inbox`}),`. It also manages `,_jsx(_components.a,{href:`/compliance/a2p-10dlc`,children:`A2P 10DLC`}),`\nregistration (the US carrier registration required to send business texts from a\nlocal number) for you.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`In short:`}),` 1) Paste your Twilio Account SID and Auth Token. 2) Register your\n10DLC brand and pick a messaging service. 3) Add numbers and finish setup.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Only `,_jsx(_components.strong,{children:`one SMS provider can be active at a time`}),` per workspace. If you already\nhave Telnyx connected, connecting Twilio will prompt you to switch — the previous\nprovider’s numbers and messaging services are removed on switch.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsx(_components.p,{children:`You need:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`A `,_jsx(_components.a,{href:`https://www.twilio.com`,children:`Twilio account`}),` with at least one phone number, or\nfunds to buy one.`]}),`\n`,_jsxs(_components.li,{children:[`Your Twilio `,_jsx(_components.strong,{children:`Account SID`}),` and `,_jsx(_components.strong,{children:`Auth Token`}),` — two codes that identify your\nTwilio account. Both are on the Twilio Console dashboard under `,_jsx(_components.strong,{children:`Account Info`}),`.`]}),`\n`,_jsx(_components.li,{children:`To be an Owner or Admin in Autocampaign AI, or have an admin give you permission to\nmanage channels.`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`You can connect with a Twilio trial number to test everything, then complete\n`,_jsx(_components.a,{href:`/compliance/a2p-10dlc`,children:`10DLC registration`}),` before sending to US numbers at volume.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`connect-twilio`,children:`Connect Twilio`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Open the Twilio channel`,children:_jsxs(_components.p,{children:[`In Autocampaign AI, go to `,_jsx(_components.strong,{children:`Settings → Channels`}),`. Under `,_jsx(_components.strong,{children:`SMS`}),`, find the `,_jsx(_components.strong,{children:`Twilio`}),`\ncard (“Enterprise SMS and MMS via Twilio”) and click `,_jsx(_components.strong,{children:`Configure`}),`.`]})}),_jsxs(Step,{title:`Enter your Twilio details`,children:[_jsxs(_components.p,{children:[`On the `,_jsx(_components.strong,{children:`Connect`}),` tab, fill in:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Where to find it`}),_jsx(_components.th,{children:`Format`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Account SID`})}),_jsx(_components.td,{children:`Twilio Console → Account Info`}),_jsxs(_components.td,{children:[`Starts with `,_jsx(_components.code,{children:`AC`}),`, 34 characters`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Auth Token`})}),_jsx(_components.td,{children:`Twilio Console → Account Info`}),_jsx(_components.td,{children:`32 characters (kept masked)`})]})]})]}),_jsxs(_components.p,{children:[`Autocampaign AI checks the format as you type — the Account SID must start with\n`,_jsx(_components.code,{children:`AC`}),` and the Auth Token must be 32 characters.`]})]}),_jsx(Step,{title:`Connect \u0026 save`,children:_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Connect \u0026 Save Credentials`}),`. Autocampaign AI checks the details with\nTwilio before saving. On success you’ll see\n`,_jsx(_components.strong,{children:`“Channel connected successfully”`}),` and the setup wizard opens automatically.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`finish-setup-messaging-service-numbers-10dlc`,children:`Finish setup (messaging service, numbers, 10DLC)`}),`\n`,_jsxs(_components.p,{children:[`After connecting, the `,_jsx(_components.strong,{children:`Set Up Your Channel`}),` wizard walks you through four steps\nin the recommended order:`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`10DLC Brand`,icon:`shield-check`,children:_jsxs(_components.p,{children:[`Register the business that will send messages. Click `,_jsx(_components.strong,{children:`Register 10DLC Brand`}),`.\nYou can’t advance until a brand exists. See the full field list in\n`,_jsx(_components.a,{href:`/compliance/a2p-10dlc`,children:`A2P 10DLC`}),`.`]})}),_jsx(Step,{title:`Service`,icon:`gear`,children:_jsxs(_components.p,{children:[`Select one or more `,_jsx(_components.strong,{children:`messaging services`}),` (the groups that hold your numbers),\nor click `,_jsx(_components.strong,{children:`Create Service`}),` and give it a name (for example, “My SMS Service”).`]})}),_jsx(Step,{title:`10DLC Campaign`,icon:`file-lines`,children:_jsxs(_components.p,{children:[`Register a campaign linked to your service, or `,_jsx(_components.strong,{children:`Skip to Numbers`}),`. A campaign\nis strongly recommended so your business texts follow US carrier rules, but it\nisn’t required to finish.`]})}),_jsx(Step,{title:`Numbers`,icon:`hashtag`,children:_jsxs(_components.p,{children:[`Assign phone numbers to your messaging service, or `,_jsx(_components.strong,{children:`Buy New Number`}),`.`]})})]}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`Finish Setup`}),` to save. You can revisit any of these from the `,_jsx(_components.strong,{children:`Service`}),`,\n`,_jsx(_components.strong,{children:`Numbers`}),`, and `,_jsx(_components.strong,{children:`Brand \u0026 Campaign`}),` tabs on the Twilio channel page at any time.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`In a hurry? `,_jsx(_components.strong,{children:`Skip Setup`}),` selects every messaging service it finds so you can\nsend immediately. Come back to register 10DLC before you send at volume.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`buy-a-phone-number`,children:`Buy a phone number`}),`\n`,_jsxs(_components.p,{children:[`From the `,_jsx(_components.strong,{children:`Numbers`}),` step (or tab), click `,_jsx(_components.strong,{children:`Buy New Number`}),`:`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Choose a `,_jsx(_components.strong,{children:`Country`}),` (required).`]}),`\n`,_jsxs(_components.li,{children:[`Optionally narrow by `,_jsx(_components.strong,{children:`Area Code`}),` or a `,_jsx(_components.strong,{children:`Contains`}),` pattern (for example, `,_jsx(_components.code,{children:`+1914`}),`).`]}),`\n`,_jsxs(_components.li,{children:[`Pick `,_jsx(_components.strong,{children:`Capabilities`}),` — `,_jsx(_components.strong,{children:`SMS`}),` (texts), `,_jsx(_components.strong,{children:`MMS`}),` (pictures), `,_jsx(_components.strong,{children:`Voice`}),` (calls);\nall are selected by default.`]}),`\n`,_jsxs(_components.li,{children:[`Click `,_jsx(_components.strong,{children:`Search Numbers`}),`, then `,_jsx(_components.strong,{children:`Buy`}),` on a result and confirm the purchase.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Numbers you buy from within a setup step are attached to the selected messaging\nservice automatically.`}),`\n`,_jsx(Heading,{level:`2`,id:`how-replies-reach-autocampaign-ai-webhooks`,children:`How replies reach Autocampaign AI (webhooks)`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/getting-started/glossary#webhook`,children:`Webhooks`}),` are the addresses Twilio uses to\nsend replies and delivery updates to Autocampaign AI. You don’t set them up\nyourself. When you finish setup, Autocampaign AI registers them with Twilio for each\nmessaging service:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Incoming messages: `,_jsx(_components.code,{children:`https://\u003cyour-app-domain>/webhooks/sms/twilio`})]}),`\n`,_jsxs(_components.li,{children:[`Delivery status: `,_jsx(_components.code,{children:`https://\u003cyour-app-domain>/webhooks/sms/twilio/status-callback`})]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Incoming webhooks are signature-verified (Twilio HMAC via `,_jsx(_components.code,{children:`x-twilio-signature`}),`),\nso only genuine requests from Twilio are accepted.`]}),`\n`,_jsx(Heading,{level:`2`,id:`check-the-channel-status`,children:`Check the channel status`}),`\n`,_jsx(_components.p,{children:`The channel header shows one of:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(Icon,{icon:`circle-check`,iconType:`solid`,color:`#16a34a`}),` `,_jsx(_components.strong,{children:`Active`}),` — connected and able to send.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Disconnected`}),` — no valid login details.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Error`}),` — your login details were rejected or a connection check failed.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Each setup tab also shows a green check when complete or an amber warning when\nsomething is still required (for example, “Brand registration required”).`}),`\n`,_jsxs(_components.p,{children:[`To disconnect, use `,_jsx(_components.strong,{children:`Disconnect`}),` on the channel header. This makes all numbers\nunusable and pauses active campaigns using the channel, so confirm carefully.`]}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Where do I find my Account SID and Auth Token?`,id:`where-do-i-find-my-account-sid-and-auth-token`,children:_jsxs(_components.p,{children:[`Both are on your Twilio Console dashboard under `,_jsx(_components.strong,{children:`Account Info`}),`. The Account\nSID starts with `,_jsx(_components.code,{children:`AC`}),`; the Auth Token is a 32-character secret you can reveal\nand copy.`]})}),_jsx(Accordion,{title:`Can I use both Twilio and Telnyx at the same time?`,id:`can-i-use-both-twilio-and-telnyx-at-the-same-time`,children:_jsx(_components.p,{children:`No. Only one SMS provider is active per workspace. Connecting a second provider\nprompts you to switch, which removes the first provider’s numbers and services\nfrom Autocampaign AI.`})}),_jsx(Accordion,{title:`Do I have to register 10DLC to send?`,id:`do-i-have-to-register-10dlc-to-send`,children:_jsxs(_components.p,{children:[`You can send with a connected channel, but US carriers require\n`,_jsx(_components.a,{href:`/compliance/a2p-10dlc`,children:`A2P 10DLC registration`}),` for reliable delivery to US\nmobile numbers. Register your brand and campaign before sending at volume.`]})}),_jsx(Accordion,{title:`Are my Twilio details stored securely?`,id:`are-my-twilio-details-stored-securely`,children:_jsx(_components.p,{children:`Yes. They are stored encrypted. After saving, the Connect tab shows the\nAccount SID and a masked Auth Token only.`})}),_jsx(Accordion,{title:`Can I change providers later?`,id:`can-i-change-providers-later`,children:_jsx(_components.p,{children:`Yes, but switching wipes the current provider’s numbers and messaging services\nin Autocampaign AI. Your campaigns using that channel are paused until you set it\nup again.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`'Invalid credentials' when connecting`,id:`invalid-credentials-when-connecting`,children:_jsx(_components.p,{children:`Twilio rejected the Account SID / Auth Token pair. Re-copy both from the Twilio\nConsole (watch for stray spaces at the end). Confirm the Auth Token is the\ncurrent one, not an old value that has since been replaced, then try again.`})}),_jsx(Accordion,{title:`'Must be a valid Twilio Account SID (starts with AC)'`,id:`must-be-a-valid-twilio-account-sid-starts-with-ac`,children:_jsxs(_components.p,{children:[`The SID field must be `,_jsx(_components.code,{children:`AC`}),` followed by 32 more characters (digits and the\nletters a–f). You likely pasted an API Key SID (`,_jsx(_components.code,{children:`SK…`}),`) or a partial value — use\nthe `,_jsx(_components.strong,{children:`Account SID`}),` from Account Info.`]})}),_jsx(Accordion,{title:`'Must be a 32-character auth token'`,id:`must-be-a-32-character-auth-token`,children:_jsx(_components.p,{children:`The Auth Token must be exactly 32 characters. Reveal and re-copy the full token.`})}),_jsx(Accordion,{title:`Customer Profile / A2P Trust Product is not compliant`,id:`customer-profile-a2p-trust-product-is-not-compliant`,children:_jsxs(_components.p,{children:[`Your Twilio TrustHub profile isn’t approved yet. Complete Twilio’s business\nprofile verification in the Twilio Console, then retry brand registration.\nSee `,_jsx(_components.a,{href:`/compliance/a2p-10dlc#troubleshooting`,children:`A2P 10DLC troubleshooting`}),`.`]})}),_jsx(Accordion,{title:`Why do messages send but replies don't appear?`,id:`why-do-messages-send-but-replies-dont-appear`,children:_jsx(_components.p,{children:`Replies reach Autocampaign AI through webhooks. Finish the setup wizard so\nAutocampaign AI can register its webhook addresses on your messaging service.\nAlso make sure the number is attached to a messaging service it manages.`})})]}),`\n`,_jsx(Card,{title:`Next: register for 10DLC`,icon:`shield-check`,href:`/compliance/a2p-10dlc`,children:_jsx(_components.p,{children:`Required for reliable US SMS delivery.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Connect Twilio","description":"Connect your Twilio account to send and receive SMS, then set up messaging services, numbers, and 10DLC.","icon":"plug","href":"/providers/twilio"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Connect Twilio","slug":"connect-twilio","depth":2,"children":[]},{"title":"Finish setup (messaging service, numbers, 10DLC)","slug":"finish-setup-messaging-service-numbers-10dlc","depth":2,"children":[{"title":"Buy a phone number","slug":"buy-a-phone-number","depth":3,"children":[]}]},{"title":"How replies reach Autocampaign AI (webhooks)","slug":"how-replies-reach-autocampaign-ai-webhooks","depth":2,"children":[]},{"title":"Check the channel status","slug":"check-the-channel-status","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"autocampaign","siteName":"Autocampaign AI","title":"Connect Twilio - Autocampaign AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-20T06:29:10.548Z","originalFileLocation":"providers/twilio.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect your Twilio account to send and receive SMS, then set up messaging services, numbers, and 10DLC.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Autocampaign AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Connect Twilio - Autocampaign AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect your Twilio account to send and receive SMS, then set up messaging services, numbers, and 10DLC.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Autocampaign AI Help Center\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.autocampaign.ai/providers/twilio\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://autocampaign.mintlify.site/_mintlify/api/og/v2?division=Connect+a+texting+provider\u0026amp;title=Connect+Twilio\u0026amp;description=Connect+your+Twilio+account+to+send+and+receive+SMS%2C+then+set+up+messaging+services%2C+numbers%2C+and+10DLC.\u0026amp;theme=c5bfef29460be693319c0a00\u0026amp;signature=cc94f34fe3b22cd85b0875974d11dde1db6cda8731b76dfd11e1de998deb9d45\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Connect Twilio - Autocampaign AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect your Twilio account to send and receive SMS, then set up messaging services, numbers, and 10DLC.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://autocampaign.mintlify.site/_mintlify/api/og/v2?division=Connect+a+texting+provider\u0026amp;title=Connect+Twilio\u0026amp;description=Connect+your+Twilio+account+to+send+and+receive+SMS%2C+then+set+up+messaging+services%2C+numbers%2C+and+10DLC.\u0026amp;theme=c5bfef29460be693319c0a00\u0026amp;signature=cc94f34fe3b22cd85b0875974d11dde1db6cda8731b76dfd11e1de998deb9d45\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/autocampaign/tb1IGVfac9o6TpkP/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Autocampaign AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4F46E5\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.autocampaign.ai/providers/twilio\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/providers/twilio.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.autocampaign.ai/#organization\",\"name\":\"Autocampaign AI\",\"url\":\"https://docs.autocampaign.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/autocampaign/82V2y2PsfqbOwMED/images/favicon_512x512_png.png?fit=max\u0026auto=format\u0026n=82V2y2PsfqbOwMED\u0026q=85\u0026s=ce400247a470f7d0e11a6dff991c26e6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.autocampaign.ai#website\",\"name\":\"Autocampaign AI\",\"url\":\"https://docs.autocampaign.ai\",\"publisher\":{\"@id\":\"https://docs.autocampaign.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.autocampaign.ai/providers/twilio#webpage\",\"url\":\"https://docs.autocampaign.ai/providers/twilio\",\"name\":\"Connect Twilio\",\"description\":\"Connect your Twilio account to send and receive SMS, then set up messaging services, numbers, and 10DLC.\",\"dateModified\":\"2026-09-20T06:29:10.548Z\",\"isPartOf\":{\"@id\":\"https://docs.autocampaign.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.autocampaign.ai/providers/twilio#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.autocampaign.ai/providers/twilio#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Autocampaign AI\",\"item\":\"https://docs.autocampaign.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Connect Twilio\",\"item\":\"https://docs.autocampaign.ai/providers/twilio\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.autocampaign.ai/providers/twilio#article\",\"headline\":\"Connect Twilio\",\"name\":\"Connect Twilio\",\"description\":\"Connect your Twilio account to send and receive SMS, then set up messaging services, numbers, and 10DLC.\",\"url\":\"https://docs.autocampaign.ai/providers/twilio\",\"mainEntityOfPage\":{\"@id\":\"https://docs.autocampaign.ai/providers/twilio#webpage\"},\"dateModified\":\"2026-09-20T06:29:10.548Z\",\"publisher\":{\"@id\":\"https://docs.autocampaign.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.autocampaign.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Autocampaign AI\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Autocampaign AI","nav":{"global":{"anchors":[{"anchor":"Support","icon":"life-ring","href":"mailto:support@autocampaign.ai"},{"anchor":"Status","icon":"signal","href":"https://status.autocampaign.ai"}]},"tabs":[{"tab":"Start here","pages":[{"title":"Start here","href":""}]},{"tab":"Contacts \u0026 CRM","pages":[{"title":"Contacts \u0026 CRM","href":"/contacts/overview"}]},{"tab":"Texting, email \u0026 WhatsApp","groups":[{"group":"Channels","pages":[{"title":"Channels overview","icon":"layer-group","href":"/channels/overview"},{"title":"SMS channel","icon":"comment-sms","href":"/channels/sms"},{"title":"Email channel","icon":"envelope","href":"/channels/email"},{"title":"WhatsApp","icon":"whatsapp","href":"/channels/whatsapp"},{"title":"Advertising channel","description":"Connect Google Ads and Meta Ads to capture leads as contacts and measure results.","icon":"bullhorn","href":"/channels/advertising"}]},{"group":"Connect a texting provider","pages":[{"title":"Connect Twilio","icon":"plug","href":"/providers/twilio"},{"title":"Connect Telnyx","description":"Connect your Telnyx account and messaging profile to send and receive SMS through Autocampaign AI.","icon":"plug","href":"/providers/telnyx"}]},{"group":"Set up email sending","pages":[{"title":"Sending domains","icon":"globe","href":"/providers/email-domains"},{"title":"Senders","icon":"user","href":"/providers/email-senders"}]},{"group":"Connect ad accounts","pages":[{"title":"Connect Google Ads","icon":"google","href":"/providers/google-ads"},{"title":"Connect Meta Ads","icon":"meta","href":"/providers/meta-ads"}]},{"group":"Texting rules \u0026 consent","pages":[{"title":"A2P 10DLC registration","icon":"shield-check","href":"/compliance/a2p-10dlc"},{"title":"Toll-free verification","icon":"phone","href":"/compliance/toll-free"},{"title":"Opt-in \u0026 auto-reply","icon":"circle-check","href":"/compliance/opt-in"},{"title":"Opt-out management","icon":"ban","href":"/compliance/opt-out"}]}]},{"tab":"Inbox \u0026 calls","pages":[{"title":"Inbox \u0026 calls","href":"/inbox/overview"}]},{"tab":"Campaigns \u0026 automation","pages":[{"title":"Campaigns \u0026 automation","href":"/campaigns/overview"}]},{"tab":"Appointments","pages":[{"title":"Appointments","href":"/scheduling/meeting-types"}]},{"tab":"Reports \u0026 billing","pages":[{"title":"Reports \u0026 billing","href":"/analytics/dashboard"}]},{"tab":"For agencies","pages":[{"title":"For agencies","href":"/agency/overview"}]},{"tab":"For developers","pages":[{"title":"For developers","href":"/developers/api-keys"}]},{"tab":"Help","pages":[{"title":"Help","href":"/support/faq"}]}]},"basePath":"","title":"Connect Twilio - Autocampaign AI","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":[],"chunks":[]}