Naxai Account Model

The Naxai account model helps you manage access, billing, and the consumption of Naxai services.

It consists of three main elements:

• Accounts
• Billing Accounts
• Subaccounts

You can customize your account structure through the Naxai Dashboard or by contacting your Naxai Account Manager.

Upon signing up for a Naxai account, a default Sub Account and a default Billing Account are automatically created. Typically, the Naxai Account requires no adjustments, but the Billing Account may need updates for invoicing. A Sub Account is essential for using any Naxai product available via the dashboard; your first Sub Account is also created automatically.

Here’s a summary of how it all works:

flowchart TD
    A[Account] -->|owns| B(Subaccount)
    A[Account] -->|owns| C(Billing Account)
    C -->|pays for| B
		C -->|pays for| A
    
style A fill:#17243D,color: #fff
style B fill:#2E7EFF,color: #fff
style C fill:#F0BA2E

Using Naxai services involves interacting with resources, such as numbers, messages, calls, and emails. These resources are exposed directly via our REST APIs or indirectly through our applications. The Naxai account model extends this concept by introducing organizational resources like Subaccounts and Billing Accounts. These resources can be related to one another, forming a resource hierarchy that mirrors your organization's structure and helps manage access to different resource groups.

Let's explore each element in detail.

Naxai Accounts

Your Naxai Account, also known as a Parent Account, is established when you register on the Naxai Dashboard. It serves two primary functions:

• It defines the relationship between your business and Naxai, consolidating all your Naxai services.
• It forms the foundational root of your business's resource hierarchy.

A Naxai Account is also associated with a Billing Account; all global resources managed by the Account are invoiced to this billing account.

Billing Accounts

When consuming Naxai services, charges are applied to the billing account linked to your Naxai Account. Billing accounts manage your account balance and store critical payment details, including name, address, currency type, and tax ID.

A single Naxai account can incorporate multiple Billing Account resources. This allows you to manage how Naxai service usage is billed by associating specific Billing Accounts with the Subaccounts they are intended to pay for.

Example: Managing Multiple Cost Centers

Consider Acme HQ, a fictional large enterprise with various departments using Naxai services. To ensure each department receives separate invoices, Acme HQ can establish a distinct billing account for each department.

flowchart TD
    A[Acme HQ] -->|owns| B(Acme Support)
    A[Acme HQ] -->|owns| C(Acme Marketing)
    A[Acme HQ] -->|owns| D(Billing Marketing)
    A[Acme HQ] -->|owns| E(Billing Support)
    D -->|pays for| B
    E -->|pays for| C
		E -->|pays for| A

style A fill:#17243D,color: #fff
style B fill:#2E7EFF,color: #fff
style C fill:#2E7EFF,color: #fff
style D fill:#F0BA2E
style E fill:#F0BA2E

💡

Default Billing Account

The default Billing Account created during your main Account creation cannot be deleted but can be renamed.

Subaccounts

To leverage Naxai's offerings, a Sub Account is a prerequisite. These accounts serve to organize resources, streamlining both access control and billing processes. When you create resources for any Naxai product (such as numbers, messages, calls, and emails), they are inherently housed within a designated Sub Account.

A Naxai account can accommodate multiple Subaccounts, typically allocated for each distinct application, environment, or team utilizing Naxai services.

Example: separate teams

Acme HQ is a company with a portfolio of products that use Naxai services. Each product is built by a separate team of developers who want to restrict access to their service configuration. This is achieved by creating a project for each team and inviting the respective team members to that project.

flowchart TD
    A[Acme HQ] -->|owns| B(Acme Digital Services)
    A[Acme HQ] -->|owns| C(Acme Finance)
    A[Acme HQ] -->|owns| D(Billing)
    D -->|pays for| B
    D -->|pays for| C
		D -->|pays for| A

style A fill:#17243D,color: #fff
style B fill:#2E7EFF,color: #fff
style C fill:#2E7EFF,color: #fff
style D fill:#F0BA2E

💡

Default Sub Account

The default Sub Account created during your main Account creation cannot be deleted but can be renamed.

Summary

The Naxai account model is designed to give you the tools needed to better organize your products, teams, and projects.:

Common shared resources

Some resources can be shared and/or associated with Subaccounts, such as users or phone numbers.

Those resources are accessed via the Account Menu.