# Managing Client Sub-Accounts

## Overview

Sub-accounts are individual client accounts managed under your agency. Each sub-account operates as a fully functional DM Champ account with its own campaigns, contacts, chats, and settings - while you maintain oversight and control from your agency dashboard.

***

## Creating Sub-Accounts

### Step-by-step:

1. Go to **Sub Accounts** in the left sidebar.
2. Click **Add Account**.
3. Fill in the client's details:
   * **First name** and **Last name**
   * **Email address** (used as the login email)
   * **Business name** (optional)
   * **Business address** (optional — city, state, postal code)
   * **Business description** (optional)
4. Click **Sign Up** to create the account.

After creation:

* A confirmation popup shows the generated password for the client.
* The client receives an email with their login credentials.
* The sub-account appears immediately in your sub-accounts list.

***

## Managing Sub-Account Access

### Client login

Each sub-account comes with login credentials. You can:

* **Share credentials with the client** so they can manage their own account.
* **Keep credentials to yourself** and manage everything on their behalf.
* **Use Assist mode** to log into the sub-account from your agency dashboard (see below).

### Assist mode

Assist mode lets you access a sub-account directly - as if you were the client - without needing their login credentials:

1. From your sub-accounts list, click the **Assist** button next to the account.
2. You are securely logged into the sub-account.
3. You can make changes, configure campaigns, manage chats, and troubleshoot issues.
4. Click **Return to Admin** to go back to your agency dashboard.

Each Assist session is secure and short-lived, so there is no risk of leaving a session open by accident.

***

## Credit Allocation and Management

### Credit management modes

Each sub-account can use one of two credit management modes, configurable in the Edit Sub Account modal:

**Manual mode (default):**

* Credits are shared from your agency pool.
* When a sub-account uses credits (AI responses, campaigns, etc.), the deduction comes from your agency balance.
* Sub-accounts do not see the credit balance - they simply use the platform and you manage the pool.
* You can manually allocate or adjust credits as needed.

**Credit reselling mode:**

* Sub-accounts purchase their own credits through your custom checkout page.
* You set the pricing - define credit packages and per-credit rates.
* Purchased credits are tracked separately per sub-account.
* AI operations consume purchased credits first before falling back to your agency pool.
* Payments can be processed through **Stripe** (automatic card charges to your connected Stripe account) or through a **webhook** (your own custom payment provider — see [Webhook Auto-Recharge](https://help.dmchamp.com/agency-accounts#webhook-auto-recharge-custom-payment-provider) for details).
* This mode is available on the Agency plan and requires the white-labeling feature flag to be enabled.

To switch between modes:

1. Go to your sub-accounts list.
2. Click **Edit** on the sub-account.
3. In the Edit Sub Account modal, toggle the **credit management mode** between manual and reselling.
4. If switching to reselling, configure your pricing tiers.
5. Click **Save**.

### Tracking usage

Monitor credit consumption across sub-accounts:

* **Credit transaction history** - View detailed logs showing which sub-account triggered each charge, the amount, the contact and campaign involved, and whether custom AI keys were used.
* **Per-account totals** - See aggregate credit usage for each sub-account.
* **Agency dashboard stats** - Get a high-level overview of total usage, active campaigns, and contact counts across all sub-accounts.

***

## Sub-Account Billing

### Agency custom checkout

If you have set up credit reselling, there are two ways to handle payments:

**Stripe (default):**

1. Connect your Stripe account in your agency settings.
2. Configure pricing tiers (e.g., "100 credits for $15," "500 credits for $60").
3. Optionally set a per-credit price for custom amounts.
4. When sub-accounts need credits, they are directed to your branded checkout.
5. Payments go to your Stripe account, and credits are delivered automatically.

**Webhook (custom payment provider):**

1. In your agency Reselling settings, enter a webhook URL in the **Auto-Recharge Webhook** section.
2. When a sub-account's credits drop below their auto-recharge threshold, DM Champ sends the details to your webhook URL.
3. Your server processes the payment using whatever provider you prefer.
4. Your server calls the DM Champ API to grant the credits.

This is useful if you operate in a region where Stripe is not available, or if you want to use a different billing system. See the [Webhooks](https://help.dmchamp.com/integrations/webhooks) and [API Access](https://help.dmchamp.com/integrations/api-access) documentation for the technical details.

### Client billing portal

Sub-accounts with active subscriptions through your agency can access a **customer billing portal** to:

* View their billing history.
* Update payment methods.
* Manage their subscription.

You can generate a link to this portal from your agency dashboard and share it with the client.

***

## Dashboard Stats for Agency

Your agency dashboard provides aggregate statistics across all sub-accounts:

* **Total active campaigns** and their statuses.
* **Credit usage** broken down by sub-account.
* **Contact counts** across all sub-accounts.
* **Campaign performance** overview.

These stats help you understand which clients are most active and where to focus your attention.

***

## Campaign Copying Between Accounts

Copy proven campaigns from one account to another:

1. Open the source campaign.
2. Select **Copy to Sub-Account**.
3. Choose the target sub-account from the dropdown.
4. The campaign is duplicated with all settings intact:
   * Bot instructions and configuration
   * FAQ entries
   * Resources and links
   * Follow-up settings
   * Template content (note: templates may need re-approval for the new account's WhatsApp number)

This saves significant setup time when onboarding new clients with similar use cases.

***

## Sub-Account Limits

Your subscription tier determines how many sub-accounts you can create:

| Tier    | Sub-Account Limit |
| ------- | ----------------- |
| Starter | 3                 |
| Growth  | 5                 |
| Scale   | 10 or 20          |
| Agency  | Unlimited         |

If you reach your limit and need more sub-accounts, upgrade to a higher tier.

***

## Best Practices

* **Set up auto-recharge on your agency account** to ensure sub-accounts never lose AI functionality due to credit depletion. Auto-recharge works with both Stripe (automatic card charges) and webhook mode (your own custom payment provider). See [Agency Accounts](https://help.dmchamp.com/agency-accounts#webhook-auto-recharge-custom-payment-provider) for details on webhook mode.
* **Use campaign copying** to quickly onboard new clients with templates that already work.
* **Monitor credit usage regularly** to catch unexpected spikes before they drain your credit pool.
* **Keep Assist mode for support** - rather than sharing agency credentials, use Assist mode to help clients directly from your dashboard.
* **Configure credit reselling** if you want sub-accounts to pay for their own usage, creating a revenue stream for your agency.
* **Choose the right credit mode per client** - use manual mode for clients you manage end-to-end, and reselling mode for clients who should handle their own credit purchases.

***

## Need Help?

If you have questions about sub-account management, reach out via our [help form](https://dmchamp.com/help).