> For a complete page index, fetch https://docs.synthflow.ai/llms.txt. For full documentation content, fetch https://docs.synthflow.ai/llms-full.txt.

# Subaccounts

> Create, configure, and manage agency subaccounts in Synthflow, including defaults for new subaccounts, deletion, and API management.

![Page subaccounts](https://storage.googleapis.com/granular-changelog/doc-images/subaccounts.png)

A subaccount is a separate workspace that sits under your main account. Each client gets their own agents, contacts, phone numbers, and call history, while you keep a single place to oversee them all.

Subaccounts are what make agency work practical at scale. You can hand a client a workspace under [your own brand and domain](/general-settings), decide how many minutes and agents they get with [Limits & Capabilities](/limits-and-capabilities), restrict which features they see with [permissions](/manage-subaccount-permissions), push ready-made agents and workflows into their workspace with [products](/import-a-product), and compare performance across every client from [one analytics dashboard](/collect-analytics#track-subaccount-analytics). Minutes come from your agency pool, so you allocate capacity rather than asking each client to buy their own.

Everything on this page is available through the interface and through the [Subaccounts API](/api-reference/platform-api/subaccounts/create-subaccount).

## Find a subaccount

Open **Admin** from the main sidebar and, under **Partner**, click **Subaccounts**. Use the search bar to search by subaccount name or subaccount ID.

## Create a subaccount

![Create subaccount](https://storage.googleapis.com/granular-changelog/doc-images/agency_subaccount_create.png)

From **Admin** → **Partner** → **Subaccounts**, click **+ Create** in the top-right corner, then  **Create New Subaccounts**. Enter a name and click **Create**.

To create several at once, click  **Add** for each additional subaccount before you confirm. Batch creation saves time when you onboard multiple clients, and every subaccount in the batch starts with the same defaults.

If you run an agency on GoHighLevel, **+ Create** also lets you [import your existing GoHighLevel subaccounts](/gohighlevel#import-subaccounts) instead of rebuilding them by hand.

## Defaults for new subaccounts

New subaccounts are not blank. They start with the values set under **Admin** → **Partner** → **Limits & Capabilities**: included minutes, whether [auto-overage](/limits-and-capabilities#auto-overage) is allowed, concurrent calls, how many agents they can create, which agent types they may use, and their workflow run cap. Permissions are inherited from the most recently created subaccount.

Review those [defaults](/limits-and-capabilities#set-defaults-for-new-subaccounts) before a batch creation run so new clients land correctly configured. Changing them later affects only subaccounts created afterward, so adjust an existing client on [its own Limits & Capabilities tab](/limits-and-capabilities#change-limits-for-one-subaccount) or [several at once](#manage-several-subaccounts-at-once).

## Manage several subaccounts at once

In **Admin** → **Partner** → **Subaccounts**, select the checkbox on each row you want to change, or the checkbox in the table header to select every subaccount. The page header shifts into select mode, where you can [import a product](/import-a-product) into all of them, [set their permissions](/manage-subaccount-permissions), and [modify their limits](/limits-and-capabilities#change-limits-for-several-subaccounts) in a single pass. Which actions appear depends on how many subaccounts you select.

A bulk limit edit requires a value for every field, so decide what each [parameter](/limits-and-capabilities#parameters) should be before you apply the change.

## Delete a subaccount

Deleted subaccounts cannot be restored.

Open **Admin** → **Partner** → **Subaccounts**, click the subaccount, select the **Settings** tab, then click  **Delete Subaccount** and confirm with **Permanently delete**.

Phone numbers that the parent account owns return to the main workspace when the subaccount is deleted. See [phone number ownership](/import-a-product#phone-number-ownership) for how ownership works across accounts.

## Manage subaccounts with the API

The [Subaccounts API](/api-reference/platform-api/subaccounts/list-subaccounts) covers the same operations as the interface, which is what you want when client onboarding runs from your own app or CRM. You can [create](/api-reference/platform-api/subaccounts/create-subaccount) a subaccount, [list](/api-reference/platform-api/subaccounts/list-subaccounts) the ones you manage, [read](/api-reference/platform-api/subaccounts/get-subaccount) a single account including `minutes_used` and `max_minutes`, [update](/api-reference/platform-api/subaccounts/update-subaccount) its limits or reset its usage counter, and [delete](/api-reference/platform-api/subaccounts/delete-subaccount) it.

## FAQ

#### Do subaccounts get their own minutes?

No. Subaccounts draw from your agency account's minute pool. Allocate what each one may use with [Limits & Capabilities](/limits-and-capabilities#included-minutes).

#### I changed the defaults, why did nothing change for my existing subaccounts?

Defaults apply only at creation. Change an existing subaccount on [its own Limits & Capabilities tab](/limits-and-capabilities#change-limits-for-one-subaccount), or edit several at once with a [bulk edit](/limits-and-capabilities#change-limits-for-several-subaccounts).

#### What happens to phone numbers when I delete a subaccount?

Numbers the parent account owns return to the main workspace. See [phone number ownership](/import-a-product#phone-number-ownership).

#### Can I create subaccounts from my own application?

Yes. Use the [Subaccounts API](/api-reference/platform-api/subaccounts/create-subaccount) to create and configure them programmatically.