VonyxDocs

Sub-accounts

Split your numbers and channels between your customers or teams.

View this page as Markdown

A sub-account is a named part of your Vonyx account. Give each of your customers or teams one, with some of your numbers and a share of your channels, so one busy campaign can't take every line.

  • A sub-account has a name, a channel limit, and the numbers you put in it.
  • Numbers you don't put in a sub-account stay on your main account.
  • Sub-accounts share your login, wallet and trunks. They are not separate logins or separate bills.

Open Sub-accounts in the console to create and manage them.

Create a sub-account

  1. Choose New sub-account.
  2. Enter a name and its channels: how many calls can run at once on its numbers.
  3. Choose Create sub-account, then tick the numbers that belong to it.

All your sub-accounts' channels together can be at most your account's channels. The bar at the top of the page shows how your channels are shared out.

You can also move a number from My numbers, in its Sub-account column.

How the limits work

Every call on a sub-account's numbers, whether SIP, Call API or campaign, counts against both the sub-account's channels and your account's channels. A call over either limit is refused.

For campaigns, only running campaigns count, by their Calls at the same time setting:

The campaign's number is inThe campaign can use up to
The main accountYour account's channels, minus those of all your running campaigns
A sub-accountThe smaller of: the sub-account's channels minus its running campaigns, and your account's channels minus all your running campaigns

Example. Your account has 6 channels; sub-accounts A and B have 3 each. A campaign on an A number is running with 2.

A new campaign onCan use up toWhy
Another A number1A has 3, and 2 are in use
A B number3B has 3 free, and your account has 4 left
A main account number4Your account has 6, and 2 are in use

The console checks this when you create a campaign and again when you press Play or Resume, since another campaign may have started, a limit changed, or the number moved in between.

Rules when you change things

When youThe console checks
Create a sub-account or change its channelsAll sub-accounts together stay within your account's channels
Lower a sub-account's channelsThe new value is at least what its running campaigns use. Pause one first if not
Move a number into a sub-accountA campaign running on the number still fits in that sub-account. Pause it first if not
Delete a sub-accountNothing: its numbers go back to your main account, and running campaigns carry on

A campaign's calls at the same time can't be changed after it is created. If it no longer fits, wait for channels to free up, or delete it and create it again.

Only active numbers can be moved; numbers on hold for verification stay where they are.

On this page