> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# White-label workspaces

> Brand your reseller workspace, manage customer workspaces, and support your users

White-label access lets an existing workspace operate as a branded reseller environment. Customers use your domain and branding while their assistants, calls, campaigns, plan, credits, and team remain isolated in separate customer workspaces.

White-label access comes either with a plan tier that includes it or as a standalone add-on bought from **Settings → Plan**. Unlike Fallbacks & Guardrails, Clone your own voice, and Revenue Autopilot, it can never be resold onward to your own customers.

## What you can customise

* **Domain** — app, login, public API (`/api/v1`), and [MCP](/api/mcp) use your verified domain.
* **Branding** — app name, logos, favicon, colours, and authentication screens.
* **Support details** — the contact information shown to your customers.
* **[Plans and pricing](/admin/plans-and-limits)** — customer-facing plans, included minutes, limits, and add-ons.
* **[Billing](/admin/stripe)** — customer checkout, subscriptions, top-ups, and invoices through your connected billing account.
* **Currency** — the display currency your customers see; stored prices remain in EUR and convert at a platform-managed rate.
* **Custom SMTP server** — send transactional email to your customers through your own mail provider instead of the platform default.
* **Mail template** — the welcome email sent right after a customer creates an account; leave fields blank to use the default text.
* **Email notifications** — which transactional emails go out to your customers.
* **Signup webhook** — an HTTP callback fired when someone signs up on your domain.
* **Bot protection** — an optional Cloudflare Turnstile challenge on your signup form, available once your custom domain is verified.
* **Retention limits** — the min/max range your customers can choose for their own data retention, separate from the default retention period you set on each plan.

White-label administration appears only when your workspace has White-label access.

## Customer workspaces

When a person registers on your white-label domain, Famulor creates a separate customer workspace owned by that person. The customer does not become a member of your reseller workspace.

This separation keeps customer resources, billing, credits, and team access independent. Manage customers from the **Tenant Admin** area or use the [White Label API](/admin/whitelabel-api) for your own onboarding and support workflows.

Open a single customer under **Users** to reach two override tools, both scoped to that one customer only:

* **Custom User Appearance** hides specific navigation pages or product features from that customer, independent of your global white-label branding and navigation.
* **Custom User Limits** overrides individual plan-limit values — such as the number of assistants, campaigns, or team members — for that one workspace. An override here takes priority over whatever the customer's subscribed plan specifies.

## Cross-customer history and live monitoring

Your admin console has its own **History** and **Live monitoring** views that aggregate every customer workspace into one place, so support and quality checks do not mean opening each workspace in turn. They are separate from the single-workspace [History](/monitoring/history) and [Live monitoring](/monitoring/live-monitoring) your customers use inside the product.

Admin History lists calls, email, and messaging conversations from every customer workspace in one grid, with a **Workspace** column identifying which customer each conversation belongs to, and opens the same detail views as the customer-facing History.

Admin Live monitoring shows the active calls across all your customer workspaces. On any of them you can listen in, whisper to the assistant, take over the conversation, or hang up — the same controls as a single workspace's own Live monitoring — alongside response-latency percentiles from the last 24 hours. This view is gated by your own reseller plan's **Live monitoring** capability, not by any individual customer's plan.

## Connect a custom domain

Open **Tenant Admin → Settings** and add the full hostname you want to use.

1. Publish the ownership TXT record shown in the setup.
2. Publish the recommended A or CNAME record for routing.
3. Wait for DNS propagation, then choose **Check DNS**.

The domain becomes active only after ownership, routing, and certificate checks succeed. Removing the domain disables sign-in and branding on that hostname.

The same workflow is available through `GET`, `POST`, and `DELETE /api/v1/custom-domain`, `POST /api/v1/custom-domain/verify`, and the matching MCP tools.

## Free accounts

You can allow free registration and define the default customer limits and pay-as-you-go minute price. New customer workspaces receive those defaults until they choose a paid plan.

You can also set **Welcome credits for new customers** under **Tenant Admin → Default Limits → Billing Configuration**. The recommended starting value is 800 credits. Each new customer receives the configured amount once as non-expiring wallet credits funded from your reseller wallet. Enter 0 to turn automatic grants off; disabling free accounts pauses grants without removing your saved amount.

If your wallet cannot cover the full amount, the customer signup still succeeds with 0 welcome credits. The missed grant is not applied later automatically. The customer list and detail view show an action to transfer the originally requested amount manually after you fund your wallet. Changes affect only customers created after you save; existing customers never receive a retroactive grant.

Use `GET` or `PATCH /api/v1/platform/welcome-credits` for the same setting, or the MCP tools `get_platform_welcome_credit_settings` and `update_platform_welcome_credit_settings` in the `platform` toolset. Customer registration and detail responses include the public welcome-credit status and the requested and granted amounts.

## User view

Authorised reseller admins can open **User view** for one of their own customers to reproduce that customer's dashboard experience. A persistent banner identifies the customer and provides a clear return to the admin area. Each session is recorded in the audit history.

Use User view only for legitimate support and administration, and follow your organisation's access policy.

## Prompt templates

Create workspace prompt and flow templates in the Tenant Admin area. They are available to your reseller team and customer workspaces according to the visibility you choose.

End users can select a template while creating an assistant or from the system-prompt card, preview it, and apply a copy. Later template changes do not overwrite an existing assistant.

The customer-visible catalog is also available through `GET /api/v1/prompt-templates` and the MCP `list_prompt_templates` tool.

## Voice catalog

Choose which voices from the platform catalog your customers can pick from in the assistant voice picker. Turn individual voices on or off in an allow-list, and add further voices to the catalog when a customer needs one that isn't listed yet.

A voice switched off further upstream carries an **Upstream** marker and cannot be turned back on from here. A voice whose text-to-speech source has been retired platform-wide is flagged separately on its row, so you can replace it on the affected assistants or delete it from the catalog.

## Moving customer resources

Reseller admins can move supported resources between their own customer accounts, for example when handing an agency-built setup to the final customer. Review assistant assignments, numbers, tools, knowledge, and billing before completing a handover.

Every migration is recorded as a run with a reviewable history — who moved what, from where, to where — and a completed run can be rolled back from the same list.