Skip to main content

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
Nested subaccounts are supported up to 5 levels, but most teams should keep one parent-child layer unless they have a clear governance reason for deeper nesting.

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
From this page, you can:
  • 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:
TabPurpose
OverviewMembers, agents, subaccounts count, created date, inherited billing plan
MembersTeam members within this subaccount
PermissionsGranular access controls by category
LimitsResource limits for this subaccount
BillingBilling mode and transfer controls
Import ProductsImport 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

1

Start transfer

In the subaccount’s Billing tab, click Transfer billing.
2

Configure transfer

Choose a grace period (24, 48, or 72 hours) during which the parent continues paying. Optionally toggle Keep agency access to stay connected as agency members after the transfer completes. Add an optional note for the customer account owner.
3

Child account completes setup

The child account sees a billing setup flow. They must add a payment method and choose a plan before the grace period expires.
4

Transfer completes

Once billing is set up, the account automatically becomes independent. If the grace period expires without setup, the parent can cancel the transfer.

Transfer States

StateBadgeWhat happens
Parent-billedPaid by parent accountParent pays, transfer button available
Transfer in progressBilling transfer in progressGrace period active, child setting up billing
IndependentIndependent accountTransfer 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
This is useful when a service provider wants to continue setup, maintenance, or monitoring after the customer becomes an independent direct-billed account.

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

PermissionDescriptionLevels
ConversationsAccess to conversations, call history, and live actionsNone, Read
TasksCreate, edit, and manage tasksNone, Read, Full

Agents

PermissionDescriptionLevels
General Agent RightsFull agent access (controls per-tab rights below)None, Read, Full
GeneralEdit agent identity and AI stackNone, Read, Full
PromptEdit agent promptsNone, Read, Full
KnowledgeManage agent knowledge sourcesNone, Read, Full
ToolsConfigure agent tools and actionsNone, Read, Full
Call FlowConfigure call flow and routingNone, Read, Full
AnalyticsManage analytics settings, goals, and post-call analysesNone, Read, Full
NotificationsConfigure agent notificationsNone, Read, Full
Knowledge BasesCreate, edit, and delete knowledge basesNone, Read, Full

Deploy

PermissionDescriptionLevels
TelephonyFull telephony access (controls sub-options below)None, Read, Full
Phone NumbersBuy, configure, and release phone numbersNone, Read, Full
SIP TrunksManage SIP trunksNone, Read, Full
Compliance ProfilesManage compliance profilesNone, Read, Full
Campaigns & ContactsView campaigns and contacts (sub-options controlled below)None, Read, Full

Account & Settings

PermissionDescriptionLevels
AccountView account (controls sub-options below)None, Limited, Full
SettingsManage account settingsNone, Read, Full
MembersInvite and manage team membersNone, Read, Full
SubaccountsCreate and manage subaccountsNone, Read, Full
Trust CenterManage retention and privacy policiesNone, Read, Full
SchedulesCreate and manage business hours schedulesNone, Read, Full
DevelopersView developer tools (controls sub-options below)None, Read, Full
IntegrationsConnect and manage integrationsNone, Read, Full
API KeysCreate and manage API keysNone, Read, Full
WebhooksCreate, test, and manage webhooksNone, Read, Full
BillingFull billing access (sub-options below)None, Full
UsageView and export usage dataNone, Full

Best Practices

Start with one parent + clear child boundaries. Add deeper nesting only for clear governance reasons.
Block categories by default for new subaccounts, then open only what each subaccount needs.
Use naming conventions that make account switching safe and obvious.
Periodically audit both member roles and blocked/allowed categories to prevent drift.

FAQs

Subaccounts can be nested up to 5 levels, but use deeper nesting sparingly. Most customer, client, brand, or department setups are easier to manage with one parent-child layer.
You can switch into subaccounts you have access to.
Yes. Open the subaccount detail and use the Permissions tab to set granular access controls per category.
Open the subaccount detail → Billing tab → click Transfer billing. Choose a grace period and start the transfer. The child account sets up their own payment method and plan during the grace window.
Yes. During a billing transfer, the target mode is set to independent. After the child account completes billing setup, the account automatically leaves the parent hierarchy.
The parent can cancel the transfer, returning the subaccount to parent billing. The parent continues to sponsor access during the grace period.
Yes. Any permissions you have configured for the subaccount remain in effect throughout the billing transfer process. Once the transfer completes and you become an agency member on the now-independent account, those permissions continue to apply until you or the account owner changes them.
For complex account restructuring, contact support@itellico.ai.

Next Steps

Billing Overview

Understand plans, usage, and extra charges

Team Management

Invite and manage members across accounts

Creating Accounts

Create additional parent accounts or subaccounts

Plans

Review plan limits and account capabilities