Twilio Resources
On This Page
How To Setup Your Twilio Line in Aptly
How to Add Your Business Name to Twilio
How to Add a New Twilio Number to 10DLC Campaign
Additional Resources
Official Aptly Guide - Connect to Twilio
Twilio Documentation - Understanding A2P 10DLC Registration
Twilio Support - Common 10DLC Errors and Denials
How To Setup Your Twilio Line in Aptly
Connecting Twilio through Aptly lets your business send and receive text messages directly from Aptly. Aptly automatically provisions your Twilio number and walks you through the required 10DLC registration for compliant SMS messaging.
Connecting Twilio through Aptly lets your business send and receive text messages directly from Aptly — no separate setup in Twilio is required. Aptly automatically provisions your Twilio number and walks you through the required 10DLC registration for compliant SMS messaging.
Step 1: Provision Your Twilio Number in Aptly
- Log in to your Aptly account.
- Click your profile photo or initials and select Settings.
- Go to the Phone Numbers section.
- Click Provision a New Number.
- Choose your area code and confirm.
Once completed, your number appears in the list of Active Numbers.
Note: Always add new numbers through Aptly — never inside Twilio. Aptly automatically connects your number to your Twilio account.
Step 2: Understand What 10DLC Registration Is
10DLC (10-Digit Long Code) is a federal compliance requirement for any business sending text messages. It verifies your company and ensures you’re following proper opt-in and opt-out standards. This process happens automatically through your connected Twilio account once a number is provisioned in Aptly.
Step 3: Register Your Brand and Campaign
- In Aptly, once your number is added, open the number’s details to begin registration.
- Enter your business information (name, EIN, and address).
- Provide sample text messages showing what you’ll send — include at least five examples.
- Include a clear opt-out phrase in your message examples, such as: “Reply STOP to unsubscribe.”
- Submit your registration and wait for approval.
Once approved, your 10DLC campaign status changes from Pending to Verified.
Step 4: Avoid Common Reasons for Denial
- Fewer than five message examples were provided.
- No opt-out language was included.
- No opt-in consent on your website forms.
Best Practice: Add an opt-in statement to every web form that collects leads, for example:
“I consent to receive text messages and calls related to my inquiry.”
This ensures your messages meet 10DLC compliance standards.
Step 5: Confirm Your Number Is Registered
Once your 10DLC campaign is verified, Aptly automatically connects your approved campaign with your phone number. If your messages aren’t sending, contact Aptly Support to confirm the registration is complete.
Step 6: Test Your Connection
- Go to Settings → Phone Numbers in Aptly.
- Verify your number shows as Active.
- Send a test text message from Aptly to ensure delivery and replies work as expected.
Add Your Business Name to Twilio
What you can do
For U.S. numbers you can set up the business name that shows when you call someone:
Twilio supports Caller ID Name (CNAM). This is the “business name” that shows up on the recipient’s phone when you call from a U.S. number. Twilio+2Twilio Help Center+2
Twilio also offers Branded Calling (for mobile calls) where you can display a verified name, logo, and call reason. Twilio+2Twilio+2
How to set it up
Here are the key steps with Twilio:
Ensure you have a U.S. number — CNAM only works for standard U.S. numbers. Twilio Help Center+1
Create a Business Profile in Twilio Trust Hub — For Branded Calling you need a profile with your business registered (EIN or DUNS) etc. Twilio+1
Assign the number to that profile and register the CNAM — Through the Twilio Console or API you assign your phone number to the profile, then register a CNAM for that number. Twilio+1
Wait for approval / database propagation — Once submitted, the change must propagate through the CNAM databases and the receiving carrier may need to support it. Twilio Help Center+1
Test outbound calls — Make some test calls to see if your business name displays.
Optional — If you want the mobile-“branded” look (logo + call reason) use Branded Calling. Twilio+1
Important limitations & gotchas
Even when you register a CNAM name, the display of that name depends on the recipient’s carrier and whether they support CNAM queries. Some mobile carriers don’t show it by default. Twilio Help Center+1
The CNAM name is limited (15 characters for traditional CNAM) and must be unique/non-generic. Twilio
For numbers outside the U.S., CNAM is often not supported. Stack Overflow
Branded Calling is still in Beta / subject to qualification in some regions. Twilio+1
Even after you set everything, changes may take time to show up in all carriers’ databases.
Summary for your scenario
Since you’re calling out from a Twilio number and want your business name to show:
If your number is U.S.-based: yes ✅ you can set up CNAM so your business name appears.
If you also want a more robust brand treatment on mobile (logo + call reason) you can apply for Branded Calling.
If your number is outside the U.S., or the recipient’s carrier doesn’t support name display, it may not show your business name.
How To Add New Twilio Number to Existing 10DLC Campaign
This quick guide shows how to associate ("register") a new US 10‑digit long code (10DLC) phone number with an already‑approved A2P 10DLC campaign in Twilio. The safest and most common path is to add the number to the Messaging Service that is linked to your campaign. Once added, Twilio handles the carrier registration in the background.
Prerequisites
Your Brand and Campaign are already approved in Twilio A2P 10DLC.
You have (or will purchase) the US 10‑digit long code number you want to use.
You know which Messaging Service is tied to the campaign.
Tip: Don’t shuffle numbers between campaigns frequently. Every move can trigger re‑registration and brief delivery downtime.
TL;DR (Fast Path)
Twilio Console → Messaging → Services → open the service that’s linked to your A2P campaign.
Go to Senders → Add Senders → Phone Numbers and add the new number.
Save. The number is now associated with the campaign through the service.
Watch status: it may show Pending Registration before becoming Registered. This can take minutes, occasionally up to 24 hours.
Step‑by‑Step (Console)
Sign in to the Twilio Console.
Navigate to Messaging → Services, then pick the Messaging Service that’s already linked to your approved campaign.
Open the Senders tab and click Add Senders.
Choose Phone Numbers, select your 10DLC number (or buy one), and Add it to the service.
Click Save/Confirm. Twilio begins carrier registration for that number under the campaign.
Monitor registration status:
Go to the number’s details or the Messaging Service dashboard.
Senders may show Pending Registration until carriers complete provisioning.
Test messaging once status is Registered (send a single opt‑in or test message consistent with your campaign use case).
Optional: Twilio CLI (advanced)
If you prefer the CLI and already have a Messaging Service SID and the Phone Number SID:
# Add a number to a Messaging Service sender pool
# Requires: twilio CLI logged in and \`TWILIO_ACCOUNT_SID/TWILIO_AUTH_TOKEN\` set
twilio api:messaging:v1:services:phone-numbers:create \
--service-sid MGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX \
--phone-number-sid PNYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY
The A2P campaign link is maintained on the Messaging Service. When you add a number to that service, Twilio associates it with the service’s campaign.
Verification Checklist
✅ Number appears under Messaging → Services → {Your Service} → Senders
✅ Service shows it’s linked to the correct A2P Campaign
✅ Number registration status is Registered (not just Pending)
✅ Test outbound message is delivered successfully
Troubleshooting
Error 30035 / carrier filtering: The number may still be provisioning or your content doesn’t match the approved use case. Wait for Registered status and send compliant content (no SHAFT content, no shortened/rotating links unless approved, include brand ID as required, etc.).
Messages fail on one carrier: Some carriers complete registration slower than others. Retest after an hour or so. If delays persist beyond 24 hours, open a Twilio support ticket with message SIDs and the Campaign/Brand SIDs.
Wrong service/campaign: Numbers only inherit the campaign of the Messaging Service they’re in. Move the number into the correct service (expect another brief registration window).
High‑volume sending too soon: Ramp up gradually after registration to avoid filtering. Follow your campaign’s declared sending patterns.
FAQs
Can I add multiple numbers to one campaign?
Yes. Add each number to the same Messaging Service that’s linked to your campaign. Ensure your use case and opt‑in flows cover all senders.
How long does registration take after I add the number?
Often minutes, occasionally up to 24 hours. Avoid frequent number moves during this time.
Do I need to re‑submit campaign details when adding a number?
No. The campaign remains the same; you’re just associating an additional sender (phone number) to the service that carries the campaign.
Can I remove a number later?
Yes, but removing and re‑adding can trigger re‑registration and downtime. Plan changes carefully.
Compliance Reminders (keep on your page)
Only send messages that match the campaign’s declared use case.
Maintain valid opt‑in and provide an easy opt‑out (e.g., STOP) and help keyword.
Keep your sender identity clear in every message.
Avoid URL shorteners not controlled by your brand unless explicitly approved.
Need help? If you’re stuck, note the Message SID(s), your Messaging Service SID, the Campaign/Brand SID, and recent timestamps; these speed up support triage.
