How Subaccounts Work
Subaccounts let a parent account create isolated customer, client, team, or business-unit accounts while keeping parent-level control. In the parent/subaccount model, itellicoAI bills the parent account centrally. The parent can then package, resell, or rebill its own customers separately. This is different from agency access, where the client owns and pays for its own itellicoAI account while granting a service provider elevated access. They are useful for:- Resellers and platform operators organizing customer accounts
- API integrators provisioning one isolated account context per customer
- Service providers that want one parent invoice from itellicoAI and their own downstream billing model
- Enterprises separating regions, brands, or departments
- Agencies that prefer to own the parent account relationship and rebill clients directly
Architecture
Parent account responsibilities
- Create and manage subaccounts
- Assign and review subaccount access categories
- Switch between accounts for oversight
- Monitor usage across subaccounts
- Manage the commercial relationship with itellicoAI when subaccounts use parent billing
Subaccount characteristics
- Own team membership and roles
- Own agents, contacts, and conversation data
- Isolated account
Creating a Subaccount
See Creating Accounts for step-by-step instructions.Managing Subaccounts
The Subaccounts table shows:- Name
- Billing plan (shows billing type, for example Parent Billing)
- Members count
- Agents count
- Minutes used
- Switch to action
- Switch directly into a subaccount
- Open permission management for a subaccount
- Expand nested hierarchies in place
Subaccount Detail
Click a subaccount row to open its detail view. The detail view has these tabs:| Tab | Purpose |
|---|---|
| Overview | Members, agents, subaccounts count, created date, inherited billing plan |
| Members | Team members within this subaccount |
| Permissions | Granular access controls by category |
| Limits | Resource limits for this subaccount |
| Billing | Billing mode and transfer controls |
| Import Products | Import agents and configuration from parent |
Billing Modes
New subaccounts use Parent Billing by default: the parent account pays for all subaccount usage, usage is consolidated on the parent’s invoice, and the subaccount has no independent billing or payment method. The Billing plan column shows Parent Billing in the subaccounts table. The parent can handle its own downstream customer billing, packaging, or resale outside itellicoAI. Best for: resellers, API integrators, telephony providers, platform operators, enterprises, and agencies that want the parent account to control billing centrally. To move billing responsibility to the subaccount, use the Billing Transfer flow described below. After a completed transfer, the account becomes fully independent and leaves the parent hierarchy.Billing Transfer
Billing transfer is the guided process for moving a parent-billed customer account into an independent direct-billed account. Access: Open a subaccount detail → Billing tab.How It Works
Configure transfer
Child account completes setup
Transfer States
| State | Badge | What happens |
|---|---|---|
| Parent-billed | Paid by parent account | Parent pays, transfer button available |
| Transfer in progress | Billing transfer in progress | Grace period active, child setting up billing |
| Independent | Independent account | Transfer complete — account manages its own billing and is no longer part of the parent hierarchy |
Agency Access After Transfer
When transferring a subaccount to independence, you can choose whether to keep agency access:- Enabled (default): former parent owners and admins are invited as agency members on the new independent account
- Disabled: no agency members are invited automatically
Subaccount Permissions
Permissions are configured per subaccount in the Permissions tab of the subaccount detail. Each permission supports None, Read, or Full access levels (some use None, Limited, Full instead).Overview
| Permission | Description | Levels |
|---|---|---|
| Conversations | Access to conversations, call history, and live actions | None, Read |
| Tasks | Create, edit, and manage tasks | None, Read, Full |
Agents
| Permission | Description | Levels |
|---|---|---|
| General Agent Rights | Full agent access (controls per-tab rights below) | None, Read, Full |
| General | Edit agent identity and AI stack | None, Read, Full |
| Prompt | Edit agent prompts | None, Read, Full |
| Knowledge | Manage agent knowledge sources | None, Read, Full |
| Tools | Configure agent tools and actions | None, Read, Full |
| Call Flow | Configure call flow and routing | None, Read, Full |
| Analytics | Manage analytics settings, goals, and post-call analyses | None, Read, Full |
| Notifications | Configure agent notifications | None, Read, Full |
| Knowledge Bases | Create, edit, and delete knowledge bases | None, Read, Full |
Deploy
| Permission | Description | Levels |
|---|---|---|
| Telephony | Full telephony access (controls sub-options below) | None, Read, Full |
| Phone Numbers | Buy, configure, and release phone numbers | None, Read, Full |
| SIP Trunks | Manage SIP trunks | None, Read, Full |
| Compliance Profiles | Manage compliance profiles | None, Read, Full |
| Campaigns & Contacts | View campaigns and contacts (sub-options controlled below) | None, Read, Full |
Account & Settings
| Permission | Description | Levels |
|---|---|---|
| Account | View account (controls sub-options below) | None, Limited, Full |
| Settings | Manage account settings | None, Read, Full |
| Members | Invite and manage team members | None, Read, Full |
| Subaccounts | Create and manage subaccounts | None, Read, Full |
| Trust Center | Manage retention and privacy policies | None, Read, Full |
| Schedules | Create and manage business hours schedules | None, Read, Full |
| Developers | View developer tools (controls sub-options below) | None, Read, Full |
| Integrations | Connect and manage integrations | None, Read, Full |
| API Keys | Create and manage API keys | None, Read, Full |
| Webhooks | Create, test, and manage webhooks | None, Read, Full |
| Billing | Full billing access (sub-options below) | None, Full |
| Usage | View and export usage data | None, Full |
Best Practices
Keep hierarchy simple
Keep hierarchy simple
Use permission categories intentionally
Use permission categories intentionally
Name subaccounts consistently
Name subaccounts consistently
Review membership and permissions regularly
Review membership and permissions regularly
FAQs
How deep can subaccounts be nested?
How deep can subaccounts be nested?
Can I switch into any subaccount from this page?
Can I switch into any subaccount from this page?
Can I configure detailed permission rules per subaccount?
Can I configure detailed permission rules per subaccount?
How do I transfer billing to a subaccount?
How do I transfer billing to a subaccount?
Can a subaccount become fully independent?
Can a subaccount become fully independent?
What happens if the child account does not set up billing during the grace period?
What happens if the child account does not set up billing during the grace period?
If I restricted certain permissions for a subaccount, will those restrictions stay active during a billing transfer?
If I restricted certain permissions for a subaccount, will those restrictions stay active during a billing transfer?
What if I need advanced ownership or hierarchy changes?
What if I need advanced ownership or hierarchy changes?