> ## 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 Setup

> Configure branding, domain, currency, legal pages, email, retention, and bot protection for your white-label platform

**Tenant Admin → Settings** is where you configure everything that makes your reseller workspace look and behave like your own product. Every field here is optional — leave it blank and Famulor falls back to the platform default.

<Note>
  Settings is organized into five groups in the sidebar: **General**, **Workspace**, **Legal**, **Communications**, and **Advanced**. This page walks through each one.
</Note>

## General

### Branding

Set the **app name** shown to your customers throughout the product (blank uses the platform default), a **support email**, and your brand colors — primary, accent, a neutral gray, and the header color used in transactional emails. These colors drive the accent used across your white-label admin console and the customer-facing app.

### Logo & favicon

Upload a light-mode logo, a dark-mode logo, and a favicon. All three are stored in a public bucket. Remove an asset to fall back to the platform default logo.

## Workspace

### Currency

Choose the **display currency** your customers see at checkout and throughout the product. Stored prices always remain in EUR internally — Famulor converts to your chosen currency at a platform-managed exchange rate for display only.

### Domains

Connect the custom domain your customers use for the app, login, the public API (`/api/v1`), and [MCP](/mcp/overview).

<Steps>
  <Step title="Add your hostname">
    Enter the full hostname you want to use (e.g. `app.your-brand.com`).
  </Step>

  <Step title="Publish DNS records">
    Publish the ownership TXT record shown in the setup, then the recommended A or CNAME record for routing.
  </Step>

  <Step title="Verify">
    Wait for DNS propagation, then choose **Check DNS**. The domain activates once ownership, routing, and certificate checks all succeed.
  </Step>
</Steps>

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. See [White Label Program](/admin/tenants-and-whitelabel) for what becomes available once your domain is verified — bot protection, for example, requires a verified custom domain.

## Legal

### Documentation link

An optional **Docs URL**. When set, it appears as an info icon next to **Create key** in **Settings → API & MCP**, pointing your customers at your own API documentation instead of Famulor's.

### Legal pages

**Privacy Policy URL** and **Terms of Service URL** — shown as links on your login and registration pages. Leave either blank to use the platform default.

## Communications

### Custom SMTP server

Send transactional email to your customers through your own mail provider instead of the platform default. Configure host, port, username, password, encryption (e.g. TLS), and the `from` name and address. Use **Send test email** to confirm the connection before relying on it — the saved password is never shown again after saving, only whether one is set.

### Mail template

The welcome email sent right after a customer creates an account. Leave fields blank to use the default text; the default contact address falls back to your support email from **Branding**.

### Email notifications

Turn individual transactional emails to your customers on or off. A missing key defaults to **on** (opt-out model). Available toggles:

| Notification         | Sent when                                                           |
| -------------------- | ------------------------------------------------------------------- |
| `welcome`            | A new customer creates an account                                   |
| `low_balance`        | A workspace's credit balance runs low                               |
| `auto_topup`         | An automatic top-up is charged                                      |
| `low_chat_credits`   | Chat/messaging credits run low                                      |
| `chat_auto_topup`    | An automatic chat-credit top-up is charged                          |
| `voice_clone_done`   | A voice cloning job finishes                                        |
| `number_deleted`     | A phone number is released                                          |
| `import_done`        | A data or knowledge-base import finishes                            |
| `export_done`        | A data export finishes                                              |
| `history_activity`   | Per-assistant history-activity alerts (workspace-level kill switch) |
| `integration_reauth` | A calendar or scheduling connection needs re-authorization          |
| `routine_paused`     | A Milian Routine auto-pauses after repeated failures                |

<Note>
  Dunning emails ("Account suspended — payment required") always send regardless of these toggles — they are a billing safeguard, not a marketing notification.
</Note>

### Signup webhook

An HTTP callback fired whenever someone signs up on your domain — use it to sync new customers into your own CRM or onboarding system.

## Advanced

### Data retention limits

Set the **min/max range** (1–24 months, or immediate deletion) your customers can choose for their own data retention in **Settings → Data Retention** — the same control model used by the platform admin. This is separate from the **default retention period** you set on each plan; the range here only bounds what a customer is allowed to pick for themselves. Limits can be set per data channel (calls, leads, email, SMS, WhatsApp, and each connected messaging channel).

### Marketing integrations

Configure GA4, Meta Pixel, Google Ads, and Microsoft UET tags for your verified custom domain — see [Marketing integrations](/settings/marketing) for the full event list and setup.

### Custom scripts

Raw HTML/`<script>` injected into your white-label pages — one field for all pages, one for auth pages only (login/register). Use this only for tags not covered by a guided field above; use with care, since this content runs unvalidated in your customers' browsers.

### Bot protection

An optional Cloudflare Turnstile challenge on your signup form, available once your custom domain is verified.

## API and MCP

Most of Settings is dashboard-only — branding, logos, domains, legal pages, SMTP, mail template, email notifications, the signup webhook, and custom scripts are configured in **Tenant Admin → Settings**, not through the public API. Marketing integrations are the exception: they're readable and writable through `GET` / `PUT /api/v1/settings/marketing` and the MCP tools `get_marketing_integrations` / `update_marketing_integrations` — see [Marketing integrations](/settings/marketing). The custom-domain workflow also has a dedicated API — see [White Label Program](/admin/tenants-and-whitelabel#connect-a-custom-domain).

See also [White Label Program](/admin/tenants-and-whitelabel) for the customer-workspace model this configuration applies to, and [White Label Platform](/admin/dashboard) for where these settings show up in your reseller dashboard.