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

# Manage Customers

> Create and manage customers.

## Create Customer

Create a new customer to create subscriptions and invoices.

<Tabs>
  <Tab title="Using Web App">
    <Steps>
      <Step title="Open Create Customer Form">
        There are several ways to open the create customer form.

        The quickest way is to click on the plus icon at the top left and then select "Customer".
        Alternatively, you can simply use `c` `n` as a keyboard shortcut.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/plus-create-shortcut.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=37d9ba4615650166518f1c6d1afe0806" alt="Plus Shortcut" width="360px" data-path="images/plus-create-shortcut.png" />
        </Frame>

        Otherwise, you can also click on ["Customers"](https://app.fynn.eu/customers) in the left navigation and then on "New".
      </Step>

      <Step title="Fill in Customer Details">
        Fill in the customer details. Depending on the customer type (individual or company), different fields are required.

        <Tip>
          By default, a customer number is generated based on the [number range](/guide/tenant/number-ranges).
          You can also set the customer number manually by clicking on "Customer Number" and entering your own number.
        </Tip>

        <Info>
          **Automatic language detection:** The customer language is automatically suggested based on the selected country.
          Customers from DACH countries (DE, AT, CH) default to German, all others to English.
          The language determines which language is used for [notifications](/en/guide/notifications/introduction) and [invoices](/en/guide/invoices/introduction).
          You can always override the suggested language manually.
        </Info>

        <AccordionGroup>
          <Accordion title="Recipient Address">
            If the recipient address is not filled in, an empty address will be automatically created. You can edit this later.

            The recipient address is used for creating [invoices](/guide/invoices) and [quotes](/guide/offers).

            <Frame>
              <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-create-address.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=2765720101be797df3e755c6286c7695" alt="Recipient Address" width="983" height="342" data-path="images/customer-create-address.png" />
            </Frame>
          </Accordion>

          <Accordion title="Different Billing Information">
            In some cases, it may be necessary for the billing email address to differ from the recipient address.

            In this case, you can fill in the different billing information.
          </Accordion>

          <Accordion title="DATEV">
            <Note>
              The DATEV integration is available as an add-on. Contact us if you would like to activate the DATEV integration.
            </Note>

            If you have activated the DATEV integration, you can enter the DATEV debtor number here or have it automatically generated based on the [number range](/guide/tenant/number-ranges).

            <Frame>
              <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-create-datev.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=2e02be921129232abd650319cd23dba4" alt="DATEV Settings" width="989" height="215" data-path="images/customer-create-datev.png" />
            </Frame>
          </Accordion>
        </AccordionGroup>

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-create-form.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=00c3bdc619509b4988ed26246d3a0e8f" alt="Create Customer" width="1042" height="799" data-path="images/customer-create-form.png" />
        </Frame>

        Now click <b>Create Customer</b> to create the customer.
      </Step>

      <Step title="Customer Successfully Created">
        The customer has been successfully created. You can now create [subscriptions](/guide/subscriptions), [quotes](/guide/offers), and [invoices](/guide/invoices) for the customer.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-details-empty.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=271cb67cafb5cb3e7ceab431589c65d9" alt="Customer Successfully Created" width="1425" height="833" data-path="images/customer-details-empty.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using API">
    Use the [Create Customer](/api-reference/customer/create-customer) endpoint for this.

    ```bash theme={null}
    POST /customers
    ```

    Alternatively, you can [retrieve the customer](/api-reference/customer/get-customer)
    or [update the customer via the API](/api-reference/customer/update-customer).
  </Tab>

  <Tab title="Import">
    Customer data import is currently possible via the following methods:

    * Creation via the [API](/api-reference/customer/create-customer)
    * DATEV debtor master import
    * Stripe import

    <Tip>
      If you are interested in a Stripe or DATEV debtor master import, or want to migrate from another subscription billing solution, please contact us.
    </Tip>
  </Tab>
</Tabs>

## Edit Customer

After creating a customer, you can edit the customer details at any time.

<Warning>
  In some cases, you may not be able to edit customer details if you do not have the appropriate permissions or if customers are read-only in the web interface.
</Warning>

To change the settings for read-only customers, see [Read-Only Customers](/guide/tenant/ui-defaults#Schreibgeschützte-Kunden).

<Steps>
  <Step title="Open Edit Customer Form">
    To edit customer details, click on "Customers" in the left navigation and select the customer you want to edit.

    Now click on "Edit" on the right side to edit the customer details.
  </Step>

  <Step title="Edit Customer Details">
    Adjust the customer details and click "Save" to apply the changes.

    <Frame>
      <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-edit-form.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=a252a13b0973fb11559f162f6cde20cf" alt="Edit Customer" width="1534" height="1998" data-path="images/customer-edit-form.png" />
    </Frame>
  </Step>

  <Step title="Edit Customer Address">
    To edit the customer's address, stay in the same form and select the appropriate dropdown in the "Addresses" section.

    Next to the address, you can edit the address using the "Pencil" icon.

    <Info>
      When changing the address, the address will also be updated for existing subscriptions if it was selected on the subscription or if the default address should be used.
      If you do not want this, please create a new address and explicitly select it on the subscription.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-edit-address.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=ca8509635f4c4b2754efd9ed2a8d9a5a" alt="Edit Address" width="1428" height="522" data-path="images/customer-edit-address.png" />
    </Frame>
  </Step>

  <Step title="Customer Successfully Edited" />
</Steps>

## Archive Customer

You can archive a customer to hide them in the customer overview.
Archived customers can be restored at a later time.

<Tabs>
  <Tab title="Using Web App">
    <Steps>
      <Step title="Archive Customer">
        To archive a customer, click on "Customers" in the left navigation and select the customer you want to archive.

        Now click on "Archive" on the right side to archive the customer.
      </Step>

      <Step title="Confirm Archive Customer">
        Confirm archiving the customer by clicking "Archive".

        <Check>
          Once archived, customers can be restored.
        </Check>
      </Step>

      <Step title="Customer Successfully Archived">
        The customer has been successfully archived and will be hidden in the customer overview.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using API">
    Use the [Archive Customer](/api-reference/customer/archive-customer) endpoint for this.

    ```bash theme={null}
    PUT /customers/{customerId}/archive
    ```
  </Tab>
</Tabs>

## Delete Customer

You can delete a customer when they are no longer needed.

To delete a customer, the following conditions must be met:

* The customer must not have any active subscriptions
* The customer must not have any invoices
* The customer must not have any completed orders
* The customer must not have any payments

<Tip>
  If any of the above criteria are not met, you can instead \[archive the customer]\(#Kunde archivieren).
  Archived customers will be hidden in the customer overview.
</Tip>

<Tabs>
  <Tab title="Using Web App">
    <Steps>
      <Step title="Delete Customer">
        To delete a customer, click on "Customers" in the left navigation and select the customer you want to delete.

        Now click on "Delete" on the right side to delete the customer.
      </Step>

      <Step title="Confirm Delete Customer">
        Confirm the deletion of the customer by clicking "Delete Permanently".

        <Warning>
          Once deleted, customers **cannot** be restored.
        </Warning>
      </Step>

      <Step title="Customer Successfully Deleted">
        The customer has been successfully deleted.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Using API">
    Use the [Delete Customer](/api-reference/customer/delete-customer) endpoint for this.

    ```bash theme={null}
    DELETE /customers/{customerId}
    ```
  </Tab>
</Tabs>

## Export Customers

To export customers as an Xlsx file, navigate to the customer overview and click "Export".
The export includes all customers created in your organization.

The export contains the following information:

* Customer master data
* Default billing address
* Default customer address
* Customer email address
* Billing email address
* Default payment method

<Frame>
  <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-export.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=c62b4aeff05b9345c3da5bab9ca6fe59" alt="Export Customers" width="1159" height="123" data-path="images/customer-export.png" />
</Frame>

## Assign Personal Contact

You can assign a personal contact for each customer. This will be displayed on quotes, in the [customer portal](/en/guide/customers/customer-portal), and in the customer detail view.

## Settings

Individual settings per customer such as payment terms, automatic sending, and dunning can be found under [Customer Settings](/en/guide/customers/settings).
