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

# Customers

> Manage the individuals and companies you bill

Customers are the individuals or companies that purchase your products or subscribe to your services. We recommend creating a customer in Hyperline as soon as they register for your product.

## Create a customer

### Manual creation

<Steps>
  <Step title="Go to the Customers section">
    Click **New Customer**.

    <Frame>
      <img src="https://mintcdn.com/hyperline/64yOuGsnZeK6uIfv/images/customers/overview.png?fit=max&auto=format&n=64yOuGsnZeK6uIfv&q=85&s=527a201cb8c69207b6309f7718c29b46" width="2478" height="1412" data-path="images/customers/overview.png" />
    </Frame>
  </Step>

  <Step title="Fill in the general information and billing details">
    Enter the customer details, then click **Save customer**.

    <Frame>
      <img src="https://mintcdn.com/hyperline/64yOuGsnZeK6uIfv/images/customers/create1.png?fit=max&auto=format&n=64yOuGsnZeK6uIfv&q=85&s=63ffd0533b97cd306d01abeba9ca48a4" width="1490" height="922" data-path="images/customers/create1.png" />
    </Frame>

    If you do not have all the information at this time, you can still create the customer and update the details later. Only a name, currency, and country are required.
  </Step>

  <Step title="Your new customer is created">
    The customer will appear immediately in your customer list (under the `All` filter).

    <Frame>
      <img src="https://mintcdn.com/hyperline/64yOuGsnZeK6uIfv/images/customers/create2.png?fit=max&auto=format&n=64yOuGsnZeK6uIfv&q=85&s=3f89f99927118e922f06ad32c08730ba" width="2482" height="1400" data-path="images/customers/create2.png" />
    </Frame>

    Click the customer's name to access their detailed information.

    On this page, you will see an overview of the customer's information on the left side of the screen. On the right, you can navigate through their [subscriptions](../subscriptions/manage), [wallet](../wallets/overview), [invoices](../invoices/overview), and events.

    <Frame>
      <img src="https://mintcdn.com/hyperline/64yOuGsnZeK6uIfv/images/customers/create3.png?fit=max&auto=format&n=64yOuGsnZeK6uIfv&q=85&s=3837db50d60a9976c89d4078999615c2" width="1490" height="922" data-path="images/customers/create3.png" />
    </Frame>
  </Step>
</Steps>

### Automatic creation

Customers can be created programmatically [using the API](../../api-reference/endpoints/customers/create-customer).

Additionally, when a CRM is connected and configured to automatically sync customers to Hyperline, customers will be created automatically.

### Default language and country

When creating a customer, the language is determined through a cascade: if explicitly provided, that value is used; otherwise, if a country is provided, the language is inferred from that country; if neither is provided, the language defaults to the invoicing entity's language.

The country follows a simpler fallback: the provided country is used if available; otherwise, it defaults to the invoicing entity's country.

This ensures that every customer has valid language and country settings, even when not explicitly specified.

## Edit a customer

Customer information can be updated at any time by clicking **Edit** in the actions dropdown.

<Frame>
  <img src="https://mintcdn.com/hyperline/bj1fTpSDtVcbg2bQ/images/customers/upload-customer-information.png?fit=max&auto=format&n=bj1fTpSDtVcbg2bQ&q=85&s=7a1a47ad18e5a123efb46f0fb3467fe8" width="2978" height="1766" data-path="images/customers/upload-customer-information.png" />
</Frame>

<Note>
  The **currency** cannot be changed in the following cases:

  * Once a customer has a wallet with funds or an active payment method (you must remove the payment method and delete the wallet first)
  * When using an external billing engine (the currency must be managed in the external tool)

  If you need to change the currency and cannot do so, please contact support.
</Note>

## Addresses

A customer has a billing address that appears on quotes, invoices, and other documents.

### Shipping address

By default, the billing address is used as the shipping address. To use a different shipping address, click the **Edit** button on the customer details page.

<Frame>
  <img src="https://mintcdn.com/hyperline/bj1fTpSDtVcbg2bQ/images/customers/shipping-details.png?fit=max&auto=format&n=bj1fTpSDtVcbg2bQ&q=85&s=a5fab63ba1853463696b924811c8c3c0" width="3398" height="1880" data-path="images/customers/shipping-details.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/hyperline/KOvRqNREMBgRrm1z/images/changelog/2024-11/shipping-addresses.png?fit=max&auto=format&n=KOvRqNREMBgRrm1z&q=85&s=340b41efd2998057ac8aeb1d84889f76" width="1364" height="1044" data-path="images/changelog/2024-11/shipping-addresses.png" />
</Frame>

When this option is enabled, customers can edit their shipping address directly from the customer portal.

<Frame>
  <img src="https://mintcdn.com/hyperline/bj1fTpSDtVcbg2bQ/images/customers/shipping-details-portal.png?fit=max&auto=format&n=bj1fTpSDtVcbg2bQ&q=85&s=807fdcf5fad82bee577a671c9452f1c4" width="3420" height="1892" data-path="images/customers/shipping-details-portal.png" />
</Frame>

Shipping details can also be displayed on quotes and invoices.

<Frame>
  <img src="https://mintcdn.com/hyperline/6Zg0fxoREoOgZ3c7/images/quotes/with-shipping-details.png?fit=max&auto=format&n=6Zg0fxoREoOgZ3c7&q=85&s=6138e12536325c2b8b1dcf873b5456d4" width="3420" height="1898" data-path="images/quotes/with-shipping-details.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/hyperline/Nzs4KUH1kGLJdieT/images/invoices/with-shipping-details.png?fit=max&auto=format&n=Nzs4KUH1kGLJdieT&q=85&s=921c66c5b458b1fd4ee2763115c941c8" width="3032" height="1852" data-path="images/invoices/with-shipping-details.png" />
</Frame>

<Note>
  Shipping address is subject to activation on our side. Please contact support if you are interested.
</Note>
