sms_status is ready before sending. To use your own throughput allowance, register your own brand and campaign, then route your numbers through them. Configure the flow in the Inkbox Console.
Running your own campaign costs $20/month on top of your identity fees — see pricing. The charge applies only while your campaign is approved by carriers: you pay nothing while registration is under review, and the charge stops if approval lapses or you delete the campaign.
Do you need to register?
Before you start
Have these on hand before you open the form. You can save a draft and come back, but the registry will reject submissions that don’t match official records exactly. For the brand (your business identity):- Legal entity type — private/public for-profit, non-profit, government, or sole proprietor.
- Legal company name as filed with the IRS and your EIN (or the equivalent if non-US).
- Registered business address (street, city, state, ZIP, country).
- Business contact email and phone.
- Public website URL.
- Your industry vertical (e.g. retail, healthcare, financial, communication).
- For public companies: stock ticker and exchange.
- For sole proprietors: a mobile phone you can receive an SMS verification code on.
- A use case (e.g. customer care, account notification, 2FA, marketing, mixed).
- A short description of what your agents will text recipients about.
- A short description of how recipients opt in (the “message flow”).
- Four sample messages that look like the real thing your agents will send. Reviewers compare submitted samples against actual traffic.
- The exact opt-in / opt-out / help keywords and auto-replies you want to use. Defaults are pre-filled (
STOP,HELP, etc.) — leave them as-is unless you have a reason to change them. - Public URLs for your privacy policy and terms & conditions. Both pages must mention SMS, that message and data rates may apply, and that recipients can opt out by replying STOP.
Step 1: Register your brand
- Open the Inkbox Console → Phone → Compliance (10DLC).
- Click Register brand and fill out the form using the details above.
- Submit. The brand status will move to Verifying while the registry runs identity checks.
- Most brands reach Verified within a few hours; some take 1–2 business days. Sole-proprietor brands need an extra step (see below).
Sole proprietors: SMS verification
If you registered as a sole proprietor, the brand stays in Verifying until you confirm the mobile number you registered. After submission, the page shows a Verify mobile phone button. Click it, the registry texts a 6-digit PIN to that number, paste the PIN back into the dialog. Once verified, the brand flips to Verified and you can move on.Brand statuses
Step 2: Register your campaign
You can only register a campaign once your brand is Verified (or Vetted).- Back on the Compliance (10DLC) tab, click Register campaign.
- Pick the use case that matches what your agents will actually send. Picking the wrong use case is the most common cause of carrier rejection.
- Fill in the description, sample messages, and opt-in/keywords/auto-replies. Provide your privacy policy and terms & conditions URLs.
- Submit. The campaign goes through two reviews — the registry first, then each major US mobile carrier.
Campaign statuses
Step 3: Route your numbers through your campaign
Once the campaign is Approved, switch your local numbers over.- On the Compliance (10DLC) tab, find the Default SMS campaign dropdown at the top of the page.
- Switch it from Inkbox to Your 10DLC profile.
- All of your numbers move onto your campaign within a few minutes.
Per-number propagation window
A number takes about 10–15 minutes to fully attach to a new campaign downstream. Sends during that window return409 sender_sms_pending. The Console flags affected numbers with a SMS pending badge until they’re ready. See Texts for the full error reference.
Rate limits
A “recipient send” is one outbound recipient onPOST /api/v1/phone/numbers/{phone_number_id}/texts. A 3-recipient group message counts as 3 recipient sends.
Group MMS and MMS sends from 10DLC local numbers are beta. Even with an approved campaign and ready sender, some carriers may reject group chats or MMS from 10DLC numbers.
Every send response — success or failure — includes
X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset so you can pace traffic. On a 429, you’ll also get Retry-After (seconds).
The error body when you hit the shared-profile limit:
Editing a campaign
Open Phone → Compliance (10DLC) in the Inkbox Console and select Edit campaign on your campaign card. Correct the fields, then review the submission button:- Save changes updates an existing campaign when you change only editable fields, such as sample messages or message flow.
- Resubmit campaign starts a new review when you change registration fields, such as the use case, description, or keywords.
Deleting a brand or campaign
- Delete a brand to start over from scratch. Deleting a brand also deletes its campaign and moves your local numbers to the Inkbox campaign. The Console asks you to type the brand name to confirm.
- Delete a campaign to remove it. The Console asks you to type
DELETE CAMPAIGNto confirm. You can edit an existing campaign without deleting it yourself.
Troubleshooting
My brand is stuck on Verifying for more than a day
My brand is stuck on Verifying for more than a day
The registry is matching the legal name + EIN you submitted against IRS records. The most common cause of a delay is a mismatch — even a trailing “Inc.” or a wrong EIN digit fails the match.If yours is past 24 hours, email hello@inkbox.ai with your organization name and the brand display name — we can pull the registry-side state for you and tell you exactly what’s wrong. In most cases the fix is to delete the brand, correct the mismatched field against your most recent IRS filing, and re-register.
My campaign was rejected — what next?
My campaign was rejected — what next?
The campaign card on the Compliance (10DLC) tab shows the rejection reason. The most common reasons:
- Sample messages don’t match the use case. If you picked “customer care” but your samples look promotional, carriers reject. Either change the use case or rewrite the samples to fit.
- Missing opt-in language. Your opt-in flow has to be described in the message flow field, and your privacy policy / terms pages have to mention SMS, message and data rates, and STOP-to-opt-out.
- Public URLs aren’t reachable. Make sure the privacy policy and terms URLs you submitted are live and don’t require login.
I sent a text right after switching to my own campaign and got 409 sender_sms_pending
I sent a text right after switching to my own campaign and got 409 sender_sms_pending
That’s expected. Routing changes take ~10–15 minutes per number to propagate downstream. Wait for the SMS pending badge in the Console to clear and try again.
Can I have multiple campaigns?
Can I have multiple campaigns?
Each Inkbox organization can have one brand and one campaign at a time today. If you need to send for materially different use cases (e.g. one-time-password traffic alongside marketing), email hello@inkbox.ai.

