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

# Add new customer

# Add a New Customer

You can add customers one at a time using the **Add Customer** form. To bulk-import many customers at once, see [Import Customers](/customers/import-customers).

**Navigate to:** Sidebar → **Users** → **Add Customer**

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-page.png" alt="Add Customer page" className="rounded-xl border" />

***

## Step 1 — Connection Type

The first thing you select is the **Connection Type**. This determines what fields appear next.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-connection-type.png" alt="Selecting connection type" className="rounded-xl border" />

| Option      | Use when                                       |
| ----------- | ---------------------------------------------- |
| **PPPoE**   | Customer connects via router username/password |
| **Hotspot** | Customer connects through a captive portal     |
| **Static**  | Customer needs a fixed, dedicated IP address   |

***

## Step 2 — Select a Plan

After choosing the connection type, select an **Internet Plan** from the dropdown. Only plans matching the connection type you selected are shown.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-plan.png" alt="Selecting an internet plan" className="rounded-xl border" />

<Note>
  If no plans appear, you need to first create a plan under **Internet Plans**. See [Creating Plans](/plans/overview).
</Note>

***

## Step 3 — Network Address & IP (PPPoE / Static only)

For **PPPoE** and **Static** customers, you will see a **Network Address** selector after picking a plan.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-ip-block.png" alt="Selecting network address and IP" className="rounded-xl border" />

1. **Network Address** — select the IP block (subnet) that belongs to the plan's pool. If the plan only has one pool, it auto-selects.
2. **IP Address** — pick an available IP from the block.
   * For **large blocks** (e.g.,/16, /18): type a prefix in the search box (e.g. `10.0.3`) and the matching available IPs appear. Click one to select it.
   * For **small blocks** (e.g.,/24, /28): a dropdown lists all available IPs directly.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-ip-search.png" alt="IP address search for large blocks" className="rounded-xl border" />

***

## Step 4 — Customer Details

Fill in the customer's personal information:

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-details.png" alt="Customer details form" className="rounded-xl border" />

| Field            | Required | Notes                                                                          |
| ---------------- | -------- | ------------------------------------------------------------------------------ |
| **Full Name**    | Yes      | Customer's full name                                                           |
| **Phone Number** | Yes      | Used for SMS notifications and M-Pesa payments                                 |
| **Email**        | No       | Optional contact email                                                         |
| **Username**     | Yes      | Login username (auto-generated or manual). For PPPoE this is the router login. |
| **Password**     | Yes      | Auto-generated by default. Click the eye icon to reveal it.                    |

### Auto-Generate Username

Click **Generate Username** to let the system create a unique username based on the customer's phone number or name.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-generate-username.png" alt="Generate username button" className="rounded-xl border" />

### Additional Account Number

Toggle **Add Additional Account Number** if the customer uses a separate account reference (e.g. a different M-Pesa paybill account number). Click **Generate** to auto-create one.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-account-number.png" alt="Additional account number toggle" className="rounded-xl border" />

***

## Step 5 — Payment & Activation

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-payment.png" alt="Payment and activation options" className="rounded-xl border" />

### Payment Method

Choose how the customer is paying at the time of registration:

| Method     | When to use                        |
| ---------- | ---------------------------------- |
| **Cash**   | The customer paid cash in hand     |
| **M-Pesa** | The customer sent money via M-Pesa |
| **Bank**   | Payment received via bank transfer |
| **Cheque** | Payment by cheque                  |

### Installation Fee

Toggle **Charge Installation Fee** if a one-time setup fee applies. Enter the amount in the field that appears.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-installation-fee.png" alt="Installation fee toggle" className="rounded-xl border" />

### Custom Amount

Toggle **Charge Custom Amount** to override the plan's normal price for this specific registration. Useful for prorated or discounted first payments.

### Auto Activate

| Setting | Effect                                                           |
| ------- | ---------------------------------------------------------------- |
| **Yes** | Customer is activated immediately on the router upon saving      |
| **No**  | Customer record is created but not provisioned on the router yet |

***

## Step 6 — Save

Click **Add Customer** to create the account. On success you will be redirected to the customer's detail page.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/lipanet/screenshots/customers/add-customer-submit.png" alt="Add Customer submit button" className="rounded-xl border" />

<Tip>
  After saving, you can send the customer their login details via SMS directly from the customer detail page using **Send Payment Details**.
</Tip>

***

## Common Errors

| Error                                          | Fix                                            |
| ---------------------------------------------- | ---------------------------------------------- |
| "Name, price, speed and validity are required" | Check the selected plan has all fields filled  |
| "IP address is required"                       | Select an available IP from the IP picker      |
| "No plans appear"                              | Create a plan first under Internet Plans       |
| "Username already exists"                      | Use Generate Username or enter a different one |
