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

**Whitelabel Admin → Settings** is where you configure your customer-facing brand and service. Choose a panel from the settings sidebar, edit its fields, and select **Save**. Branding fields can inherit platform defaults; domain verification and email delivery have their own setup requirements.

<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.

Open **Whitelabel Admin → Settings → Branding**. Enter **App name** and **Support email**, choose the brand colors, then select **Save**.

<Frame caption="Branding — app name, support address and color controls">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-branding.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=2a0d20d5961517dbb6dcdacf491dccfc" alt="Branding — app name, support address and color controls" width="2230" height="512" data-path="images/guide-ui/white-label-branding.png" />
</Frame>

### Logo & favicon

Open **Settings → Logo & favicon**. Use **Upload logo**, **Upload dark logo**, and **Upload favicon** to add the assets for each display context. Uploads and removals apply immediately. Remove an asset to fall back to the platform default logo.

<Frame caption="Logo & favicon — separate uploads for the light logo, dark logo and favicon">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-logos.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=4ab70aa7b7c9229fcc72d9358f362832" alt="Logo & favicon — separate uploads for the light logo, dark logo and favicon" width="1978" height="263" data-path="images/guide-ui/white-label-logos.png" />
</Frame>

## 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).

Open **Whitelabel Admin → Settings → Domains**, enter your hostname in **Custom domain**, then select **Add domain**. The screenshot shows the form before a domain has been added; the DNS records appear in the next step.

<Frame caption="Domains — add your hostname before publishing and verifying DNS records">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-domains.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=d83dc8c13dae54a21d3c73a0194990d8" alt="Domains — add your hostname before publishing and verifying DNS records" width="2228" height="330" data-path="images/guide-ui/white-label-domains.png" />
</Frame>

<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 **From 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.

Open **Whitelabel Admin → Settings → SMTP** to enter your mail-server and sender details. Save the configuration, then use **Send test email** to check delivery.

<Frame caption="SMTP — unconfigured server and sender fields">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-smtp.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=3d2a8e536ab7ada9ae502612dc50fd8c" alt="SMTP — unconfigured server and sender fields" width="2228" height="829" data-path="images/guide-ui/white-label-smtp.png" />
</Frame>

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

Open **Settings → Email notifications**. Turn each notification on or off, then select **Save**. Notifications are enabled by default. The labels match the switches in the product:

<Frame caption="Email notifications — switches for customer account and activity emails">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-email-notifications.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=2965270cb8d5d509768c9322a2f13cf9" alt="Email notifications — switches for customer account and activity emails" width="1980" height="1111" data-path="images/guide-ui/white-label-email-notifications.png" />
</Frame>

| Notification | Sent when |
| - | - |
| **Welcome email** | A new customer creates an account |
| **Low balance alert** | A call is blocked because the workspace has insufficient credits |
| **Auto top-up receipt** | An automatic top-up is charged |
| **Low chat credits** | Chat/messaging credits run low |
| **Chat auto top-up receipt** | An automatic chat-credit top-up is charged |
| **Voice clone ready** | A voice cloning job finishes |
| **Phone number released** | A phone number is released |
| **Import finished** | A data import finishes |
| **Export finished** | A data export finishes |
| **History activity** | New call, message, or email activity; this switch controls the workspace-wide notification setting |
| **Integration reconnect required** | A calendar or scheduling connection needs re-authorization |
| **Mission paused** | A Milian Mission auto-pauses after repeated failures |
| **Booking alerts** | A booking comes in, 15 minutes before it starts, and when it starts (push to the workspace team in the mobile app) |

<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**. 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).

Open **Whitelabel Admin → Settings → Data retention**. Set the permitted minimum and maximum for each channel, then select **Save**.

<Frame caption="Data retention — minimum and maximum periods customers may choose">
  <img src="https://mintcdn.com/ouraicall/bijtnxODi_f3mm69/images/guide-ui/white-label-retention.png?fit=max&auto=format&n=bijtnxODi_f3mm69&q=85&s=c4d0cff49a30018019d5b16f1d3584a1" alt="Data retention — minimum and maximum periods customers may choose" width="1980" height="428" data-path="images/guide-ui/white-label-retention.png" />
</Frame>

### 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, legal pages, SMTP, mail template, email notifications, the signup webhook, and custom scripts are configured in **Whitelabel 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.