Your First Tenant in 5 Minutes
Create your first customer account.
What a tenant is
A tenant is one of your customers — a business with its own phone numbers, extensions, users, voicemail, and call routing. Each tenant is fully isolated. Tenant A can't see Tenant B's data, calls, or settings.
You'll create one tenant per customer. A small business with three people is one tenant. A 200-person company with five departments is also one tenant — they manage their own internal structure inside the tenant.
Creating your first tenant
Click Tenants → Tenants in the top nav. You'll land on the tenants list. If this is your first one, you'll see an empty state with a New Tenant button in the top right.
Click New Tenant. A form appears with these fields:
| Field | What to enter | Notes |
|---|---|---|
| Tenant Name | The customer's business name. | Shows up everywhere — invoices, dashboards, etc. |
| SIP Prefix | A short alphanumeric string (3-12 chars). | Auto-suggested from the name. Used internally to namespace SIP credentials. Cannot be changed later. |
| Billing Email | Where invoices and billing notifications go. | Usually the customer's accounting or admin contact. |
| Default CNAM | Caller ID name for outbound calls. Max 15 chars. | This is the name that displays on the receiving phone — like "ACME PLUMBING". |
| Timezone | Customer's local timezone. | Affects scheduled campaigns, call history timestamps, and analytics. |
| Status | TRIAL / ACTIVE / SUSPENDED / CANCELLED. | Set to TRIAL while you're getting them set up; flip to ACTIVE when they're paying. |
| E911 Address | Physical service address. | Required by law for emergency-services routing on at least one number per location. We'll cover this properly in the Phone Numbers chapter. |
Click Create. The tenant appears in the list with their SIP prefix, status badge, and counts for users, DIDs, and extensions (all zero at this point).
What just happened
When you create a tenant, the platform spins up:
- An isolated account scoped to that tenant
- An empty SIP context for their extensions
- A billing record under your partner account
- A default voicemail context (used the first time someone enables voicemail)
Nothing is charged yet. You're not billed for an empty tenant. Charges start once the tenant has assigned DIDs or active extensions, depending on your billing model.
Managing the tenant
Click the tenant's name in the list to open their dashboard. You're now seeing what your customer sees — extensions, phone numbers, call flows, voicemail, all the day-to-day controls. Use this view to set up the basics for them, or hand it off and let them do it.
The breadcrumb at the top will always show "Tenants → [Tenant Name]" so you know which tenant you're inside. Click your brand logo at the top to go back to the partner dashboard.
What's next
Your tenant exists, but they don't have a phone number yet. Let's fix that.