Two entry points
From the inbox setup wizard
If you’re still setting up, the Inbox Setup Wizard at/{org}/inbox/setup lets you choose “Phone” and walks through search → select → checkout → add to organization.
From the purchases page
Once you’re past initial setup:- Go to Purchases in the sidebar.
- Click Purchase Phone Numbers.
- You land on the phone number search page.
The purchase flow
- Choose a location — select country and (optionally) area code or region.
- Pick available numbers — ShingleAI queries Telnyx and lists available numbers with features (SMS, voice, MMS) and any per-number monthly cost.
- Review — confirm your selection and the calculated total.
- Checkout — you’re redirected to Stripe to pay.
- Success — you land back on ShingleAI’s success page, and the number attaches to your organization automatically. The
phone_number_provisionmetric is emitted for billing.
You can select multiple numbers in a single checkout. The total reflects Telnyx pricing for each number.
Adding a number you already own
If you already have a Telnyx number and want to attach it directly:- Go to Phone Numbers.
- Click Add Phone Number to open the inline form (or visit
/{org}/phone-numbers/newfor the full-page version). - Fill in:
- Name — a label you’ll recognize
- Phone number — in E.164 format (for example
+14155550123) - Country code and Region
- Provider — Telnyx
- Save.
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| No available numbers in search | Area code out of stock at Telnyx | Try a nearby area code or a broader region |
| Stripe checkout fails | Payment method issue | Update in Billing |
| Purchase succeeded but number not listed | Webhook lag | Wait 30–60 seconds and refresh |
Next steps
Configuring a phone number
Turn on SMS, voice, voicemail, recording
Purchases
See your purchase history