Managing virtual numbers
Assign, release, sync, and purchase pooled numbers in Intry Admin.
Prerequisites
- Access to Intry Admin with admin API permissions (Clerk or WorkOS SSO).
- Correct environment selected (Dev / Test / Staging / Prod).
Open Virtual numbers
- Sign in to Intry Admin.
- Sidebar → Virtual numbers.
Typical workflows
View inventory and health
- Review summary: available, assigned, quarantined.
- Check health and sync warnings.
- Use filters by status, area code, property.
Assign a number to a unit
- Confirm number is available (not quarantined).
- Choose Assign → select unit.
- Save. Test inbound in non-prod before production reliance.
Release a number from a unit
- Choose Release from number detail or unit editor.
- Number enters quarantine — may not be immediately reusable.
Sync with carrier
Use Sync when Twilio or Telnyx console changes were made outside Intry:
- Run Sync (
POST /api/admin/virtual-numbers/sync). - Review result for orphans or mismatches.
Also available: Reconcile for deeper DB vs carrier comparison.
Purchase numbers
- Search available by area code.
- Purchase only needed quantity (billing approval if required).
- Numbers appear as available for assignment.
Provider determined by property override or purchase param (twilio or telnyx).
Environment switching
Always double-check the environment tab before purchasing or releasing in production.
Troubleshooting
| Symptom | What to check |
|---|---|
| Inbound calls not reaching unit | Correct VN on unit; not quarantined; webhook URLs match provider |
| Number missing | Run Sync; verify carrier account; correct admin environment |
| Cannot assign | Number assigned elsewhere; tenant at cap (units + 5) |
| Low pool | Purchase numbers; see Virtual number pool |
Escalation
File ticket with: environment, E.164, carrier SID, unit id, failure time.
Last verified: 2026-06-21 (commit 293c4a7)