Skip to main content

Twilio SMS Setup Guide (Self-Serve)

Creating your own Twilio account, registering for A2P 10DLC messaging, and connecting it to Customer.io

T
Written by Tommy Sardo

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:

  1. Create and upgrade your Twilio account

  2. Create a Messaging Service and buy a phone number

  3. Create your Customer Profile and register your Brand

  4. Register your Campaign

  5. Attach your phone number to the Campaign

  6. 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.

Choose an 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.

Account details

5. On the Review screen, confirm Billing Country is United States and click Create new account.

Review and 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.

Welcome questions

Your new account opens in trial mode:

Account dashboard 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.

Admin menu, Account billing

2. Click Upgrade Now.

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.

Upgrade your account wizard

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.

Auto Recharge settings

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.

Admin menu, Account management

2. Under Manage account, select Manage users.

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

  1. In the Twilio Console, go to Messaging → Services and click Create Messaging Service.

  2. Enter "Marketing" as the name and select Market my services.

  3. Click Create Messaging Service.

  4. Click Add Senders. When the pop-up appears, click Buy One Here.

  5. Choose a local US number with SMS capability and click Buy.

  6. Check "I agree to comply with the Emergency calling terms and conditions," then click Buy +1 XXX XXX XXXX.

  7. Click Configure +1 XXX XXX XXXX.

  8. 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:

Messaging Services page

Naming the service and choosing its purpose (some Console layouts show this as a multi-step setup):

Messaging Service setup

Add Senders → Phone numbers, where you buy or select your number:

Add Senders phone numbers

On your number's Configure tab, the Initiate A2P 10DLC registration link starts Step 3:

Initiate A2P 10DLC registration

Step 3: Create your Customer Profile and register your Brand

Start the registration

  1. Click Brands, then Register a Brand.

  2. Click Yes for business entity.

  3. Select Yes, the business I'm registering has a tax ID.

  4. 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.

Determine profile needs

Customer Profile

  1. Go to Messaging → Regulatory Compliance → Onboarding if you aren't taken there automatically.

  2. Search for US EIN (Tax ID) and enter your EIN.

  3. If Twilio says it's unable to find your business information, click Continue. A section will appear to enter the EIN again.

  4. 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

  5. Select Enter new address and fill out your business address. Click Save and Continue.

  6. Fill out the Contact Information for your first authorized representative, using your own business email.

  7. Add a second representative if you have one. If not, select No, confirm the notification settings, and click Save and Continue.

  8. Review, check "I declare that the information provided is accurate," and click Submit for review.

Business Details (select Direct Customer):

Business details form

Business Address:

Business address form

Authorized Representatives:

Authorized representatives form

Twilio emails you when the Customer Profile is approved, usually within a few business days.

Submit your Brand

  1. Select Standard. (Low-Volume Standard is an option if you'll send fewer than ~6,000 message segments per day.)

  2. Check the box agreeing that the information is correct and to the one-time brand registration fee.

  3. Click Register.

Submit Brand screen. Fees shown here are from an older screenshot; your Console shows current pricing.

Submit Brand

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:

Finish setting up your number checklist

Step 4: Register your Campaign

  1. Go to Messaging → Services and open your Marketing service.

  2. Click A2P & Compliance, then Connect A2P Campaign.

  3. Select the A2P Brand you just registered.

  4. Click Available A2P Campaign use cases and select Marketing.

  5. 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):

Approved campaign description and content

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):

Approved sample messages

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):

Approved end user consent

Submit

  1. Click Create, then Confirm.

  2. 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.

Confirm and submit registration

An approved Campaign shows your Brand as Approved on its Registration Details page:

Approved campaign registration details

Step 5: Attach your phone number to the Campaign

Once your Campaign is approved:

  1. Under Messaging, click Regulatory Compliance, then select Campaigns.

  2. Open your Campaign and click the Linked Messaging Service (the blue text).

  3. On the Sender Pool page, click Add Senders, then Continue.

  4. 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:

Senders page with number attached

You're now ready to send a test text message.

Step 6: Connect Twilio to Customer.io

Copy your Account SID and Auth Token

  1. Log in to Twilio.

  2. On the Console home page, find the Account Info panel.

  3. 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:

Account Info panel with copy buttons

You can also find both under API keys & auth tokens (Auth Tokens tab). Use the Live credentials, not the Test credentials:

API keys and auth tokens page

Add them in Customer.io

  1. In Customer.io, click the gear icon and go to Workspace Settings → SMS.

  2. Under Twilio Actions → Authorization, enter your Account SID and Auth Token.

  3. 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:

Customer.io Twilio settings

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.

Need help?

Reach out to your Lunchbox Account Manager or [email protected]. We're happy to review your Campaign fields before you submit.

Did this answer your question?