This guide walks you through setting up SMS marketing on your own Twilio account, then connecting it to your Customer.io workspace. Every example below comes from a real campaign that Twilio approved, with client details replaced by [placeholders].
Overview
US carriers require any business texting customers from a standard 10-digit number to register under A2P 10DLC (Application-to-Person, 10-Digit Long Code). You'll complete these parts in order:
Create and upgrade your Twilio account
Create a Messaging Service and buy a phone number
Create your Customer Profile and register your Brand
Register your Campaign
Attach your phone number to the Campaign
Connect Twilio to Customer.io
Billing: Twilio bills you directly. Registration fees, phone number rental, and per-message charges go on the payment method in your Twilio account. None of it is billed through Lunchbox.
Timing: plan for several weeks from start to approval. Most of that time is carrier review of your Campaign, so start early and check your Twilio account regularly while it's in review.
Before you start: have these ready
Item | Notes |
Legal business name | Exactly as it appears on your IRS EIN letter (CP-575 or 147C), including "LLC" and punctuation |
EIN (Tax ID) | Must match the legal name above |
Business address | Matches IRS records |
Business website | Your customer-facing brand site |
Online ordering URL | Your Lunchbox ordering site, e.g. order.yourbrand.com |
Authorized representative | Name, title, business email, and mobile number of someone who can sign for the business |
Brand-name document (if needed) | Only if your customer-facing brand name differs from your legal entity name. See below. |
Opt-in screenshot | A screenshot of your ordering site's account sign-up screen. Your Lunchbox TAM can provide one. |
Payment method | For your Twilio account. Registration isn't available on trial accounts. |
If your brand name differs from your legal entity name
Many restaurant groups operate a brand (e.g. "Main Street Burgers") under a differently named legal entity (e.g. "Parent Holdings LLC"). If that's you:
Use the legal entity name tied to your EIN for the Customer Profile and Brand.
Get a document that legally connects the two names (DBA / assumed name certificate, trade name filing, or similar).
Upload it to a publicly viewable link (e.g. Google Drive set to "Anyone with the link can view").
Reference that link in your Campaign description, as shown in Step 4.
This lets reviewers match your legal entity to the brand name on your website and in your messages.
Hosting your opt-in screenshot
Reviewers can't log in to your ordering site, so they need to see your sign-up screen another way. Upload the screenshot to a publicly viewable link the same way. You'll paste it into the Campaign in Step 4.
Step 1: Create and upgrade your Twilio account
Sign up and create the account
1. Go to twilio.com and sign up with a shared business email (e.g. [email protected]) rather than a personal one, so access survives staff changes. The person who signs up becomes the account's first administrator.
2. Verify your email and a mobile phone number.
3. On the Choose an Account screen, click Create New Account.
4. Under Account details, enter your business name as the Account friendly name and select Twilio for what the account will be used for.
5. On the Review screen, confirm Billing Country is United States and click Create new account.
6. Answer Twilio's welcome questions:
What do you plan to build: Other
Which product: SMS
Which best describes you: Business
How you will use Twilio: Direct Brand
How you want to build: With no code at all
Your goal today: 3rd party integrations
7. Click Get Started with Twilio.
Your new account opens in trial mode:
Upgrade the account
Registration isn't available on trial accounts, so upgrade before moving on.
1. Click Admin in the top right and select Account billing.
2. Click Upgrade Now.
3. Complete the four parts of the upgrade wizard: Customer profile (a valid ID for the administrator plus your business details), Main address, Starting balance, and Payment details (credit card). Twilio bills this payment method directly for everything in this guide.
Turn on auto-recharge
In Account billing → Payment Settings, open the Auto Recharge tab. Set the balance that triggers a recharge, the amount to bring it back up to, and your payment method, then click Save. This keeps texts from stopping mid-campaign when your balance runs low.
Invite Lunchbox to your account
Giving Lunchbox access lets us review your setup and help if anything gets stuck.
1. Click Admin in the top right and select Account management.
2. Under Manage account, select Manage users.
3. In the upper-right corner, select Invite user →.
Enter the email address to invite: [email protected]
Select Developer and Support.
At the bottom of your screen, click Send invitation.
Recommended: invite a second admin from your own team the same way, so you're never locked out.
Step 2: Create a Messaging Service and buy a phone number
In the Twilio Console, go to Messaging → Services and click Create Messaging Service.
Enter "Marketing" as the name and select Market my services.
Click Create Messaging Service.
Click Add Senders. When the pop-up appears, click Buy One Here.
Choose a local US number with SMS capability and click Buy.
Check "I agree to comply with the Emergency calling terms and conditions," then click Buy +1 XXX XXX XXXX.
Click Configure +1 XXX XXX XXXX.
Scroll to Messaging Configuration and click Initiate A2P 10DLC registration. This takes you into Step 3.
Messaging Services page, with Create a Messaging Service at the top right:
Naming the service and choosing its purpose (some Console layouts show this as a multi-step setup):
Add Senders → Phone numbers, where you buy or select your number:
On your number's Configure tab, the Initiate A2P 10DLC registration link starts Step 3:
Step 3: Create your Customer Profile and register your Brand
Start the registration
Click Brands, then Register a Brand.
Click Yes for business entity.
Select Yes, the business I'm registering has a tax ID.
Choose to register your own business directly (you are the direct customer, not a reseller or software provider).
The registration starts by asking about your business. The screenshots in this step come from an earlier Twilio Console layout, so labels may sit in slightly different places on your screen.
Customer Profile
Go to Messaging → Regulatory Compliance → Onboarding if you aren't taken there automatically.
Search for US EIN (Tax ID) and enter your EIN.
If Twilio says it's unable to find your business information, click Continue. A section will appear to enter the EIN again.
Create the Customer Profile and fill out all Business Details:
Legal Business Name: exactly as on your EIN letter
Business Identity: Direct Customer
Business Type: e.g. Limited Liability Corporation
Business Registration ID Type: EIN
Business Registration Number: your EIN
Business Industry: Food & Beverage
Website URL: your brand's main website (not the ordering site)
Business Regions of Operations: USA & Canada
Select Enter new address and fill out your business address. Click Save and Continue.
Fill out the Contact Information for your first authorized representative, using your own business email.
Add a second representative if you have one. If not, select No, confirm the notification settings, and click Save and Continue.
Review, check "I declare that the information provided is accurate," and click Submit for review.
Business Details (select Direct Customer):
Business Address:
Authorized Representatives:
Twilio emails you when the Customer Profile is approved, usually within a few business days.
Submit your Brand
Select Standard. (Low-Volume Standard is an option if you'll send fewer than ~6,000 message segments per day.)
Check the box agreeing that the information is correct and to the one-time brand registration fee.
Click Register.
Submit Brand screen. Fees shown here are from an older screenshot; your Console shows current pricing.
Your Brand will show your legal entity name. That's expected. Once the Brand is registered, continue to Step 4.
Twilio tracks your progress on the number's setup checklist. Once the Campaign in Step 4 is submitted, all four items show Complete:
Step 4: Register your Campaign
Go to Messaging → Services and open your Marketing service.
Click A2P & Compliance, then Connect A2P Campaign.
Select the A2P Brand you just registered.
Click Available A2P Campaign use cases and select Marketing.
Fill out each field below exactly as shown, replacing anything in [brackets].
Every field should tell the same story: the same brand name, the same website, the same purpose, and the same opt-out wording.
Campaign description
Say who is sending, who receives the messages, and why. Name your customer-facing brand.
This campaign sends marketing messages from [Brand Name] ([Legal Entity Name] is the parent company to [Brand Name]: [public link to brand-name document]) to customers who have opted in and want to know about events, specials, and new information from the brand. These communications are sent via the brand's online ordering web and app products: https://[order.yourbrand.com]/ If you provide us with your mobile phone number, we may send you SMS text messages about your Lunchbox Account and/or order. Please note that your carrier may charge you for the text messages you receive. To stop receiving SMS text messages from us text STOP, CANCEL, or UNSUBSCRIBE in reply to any SMS text message sent by us. https://lunchbox.io/privacy
If your legal entity name and brand name are the same, leave out the parenthetical.
Message contents, terms, and privacy policy
Field | Answer |
Messages contain embedded links | Yes |
Messages contain phone numbers | Yes |
Direct lending or other loan arrangement | No |
Age-gated content | No |
Campaign's terms and conditions | |
Campaign's privacy policy |
Approved example of the description and content fields (client details hidden):
Sample messages
Start each sample with your brand name and end it with the same opt-out sentence used in your description. Base them on real promos you plan to send.
Sample message #1: [First name], it's [Brand Name]. Thanks for opting in to receive SMS notifications. We're excited to keep you up to date with [Brand Name]'s specials and events! To stop receiving SMS text messages from us text STOP, CANCEL, or UNSUBSCRIBE in reply to any SMS text message sent by us.
Sample message #2: [First name], it's [Brand Name]. Thanks for opting in to receive SMS notifications. We have "[Menu Item]" back for a limited time! Order now from our app and get yours today. To stop receiving SMS text messages from us text STOP, CANCEL, or UNSUBSCRIBE in reply to any SMS text message sent by us.
Approved example (client details hidden):
End user consent (message flow)
Under How do end-users opt in to receive messages?, describe the sign-up flow and include the public link to your opt-in screenshot:
End users opt-in when creating an account at https://[order.yourbrand.com]/. They are required to include a phone number and check off "I want to receive order updates and promotions via text. Message and data rates may apply" and they are prompted with the message, "By creating an account, you agree to Lunchbox's Terms of Service & Privacy Policy ([public link to opt-in screenshot]) (which includes CONSENT TO ELECTRONIC COMMUNICATIONS before they hit Submit.
Leave the keyword and auto-reply fields at Twilio's defaults:
Field | Value |
Opt-out keywords | OPTOUT, CANCEL, END, QUIT, UNSUBSCRIBE, REVOKE, STOP, STOPALL |
Opt-out message | You have successfully been unsubscribed. You will not receive any more messages from this number. Reply START to resubscribe. |
Help keywords | HELP, INFO |
Help message | Reply STOP to unsubscribe. Msg&Data Rates May Apply. |
Approved example (client details hidden):
Submit
Click Create, then Confirm.
Your Campaign is now in review. Twilio emails the address on your account when it's approved, or if anything needs changing. If it comes back, see Troubleshooting below.
An approved Campaign shows your Brand as Approved on its Registration Details page:
Step 5: Attach your phone number to the Campaign
Once your Campaign is approved:
Under Messaging, click Regulatory Compliance, then select Campaigns.
Open your Campaign and click the Linked Messaging Service (the blue text).
On the Sender Pool page, click Add Senders, then Continue.
Check the box next to your phone number and click Add Phone Numbers. Confirm your selection.
Your number listed in the Messaging Service's Sender Pool:
You're now ready to send a test text message.
Step 6: Connect Twilio to Customer.io
Copy your Account SID and Auth Token
Log in to Twilio.
On the Console home page, find the Account Info panel.
Copy the Account SID and Auth Token. You'll paste these into your Customer.io Twilio integration.
The Account Info panel on your dashboard has a copy button for each:
You can also find both under API keys & auth tokens (Auth Tokens tab). Use the Live credentials, not the Test credentials:
Add them in Customer.io
In Customer.io, click the gear icon and go to Workspace Settings → SMS.
Under Twilio Actions → Authorization, enter your Account SID and Auth Token.
Click Validate Credentials once both are entered. Your account is now integrated with Twilio, and setup is complete.
Where the Account SID and Auth Token are entered in Customer.io:
Don't have access to add this in your Customer.io workspace? Send your Account SID and Auth Token to Lunchbox Support ([email protected]) and/or your Account Manager and we'll add them for you. Treat the Auth Token like a password: share it through a secure method, or set up a quick screen share with us instead of emailing it.
Sending best practices
Always include your brand name at the start of each message, e.g. "[Brand Name]: …"
Use Newsletter-type Broadcasts in Customer.io for SMS. API-triggered broadcasts don't work properly with Twilio SMS.
Don't send to unsubscribed people. Leave "Send to unsubscribed people" set to No.
Pace large sends over a few hours rather than all at once to avoid carrier filtering.
Links: URLs need "www" to hyperlink properly. Link previews don't display in SMS.
Discourage replies other than opt-out keywords. Inbound replies can add charges to your Twilio bill.
Frequency: keep to roughly 2–4 marketing texts per month, matching the opt-in language guests agree to.
Troubleshooting
If your Campaign comes back rejected, Twilio's email lists an error code. Open the Campaign in the Console, click Edit & resubmit, fix every listed reason, and resubmit. Each resubmission restarts the review.
Error | What it means | How to fix it |
Brand name doesn't match EIN | The Customer Profile or Brand used your brand name instead of the legal entity name tied to your EIN | Use the exact legal name from your IRS letter. Connect it to your brand name in the Campaign description (Step 4). |
30886 | The Campaign description doesn't clearly explain who sends, who receives, and why, or doesn't match your samples and Brand | Use the Step 4 description. Name your brand explicitly and use the same brand name in both samples. |
30908 | The privacy policy couldn't be verified, or the opt-out details are missing | Use https://lunchbox.io/privacy in the privacy field and at the end of the description. Add the full opt-out sentence to the description and every sample message. |
30907 | Reviewers can't connect your website's brand name to the legal entity on your registration | Upload a document linking the two names to a public link and reference it in the Campaign description (Step 4). |
30909 | Reviewers can't verify how guests opt in | Add the public link to your opt-in screenshot and the full consent wording to the message flow field. |
Twilio's A2P 10DLC Campaign Approval Requirements has more detail.
Need help?
Reach out to your Lunchbox Account Manager or [email protected]. We're happy to review your Campaign fields before you submit.
