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

# Creating a Holder

> Create a new Holder in the Midaz Module as an Individual or Corporate record to represent the person or company that owns one or more Accounts.

A Holder represents the person or company behind one or more Accounts. Create the Holder before you create Alias Accounts. An Alias Account connects customer-facing account information to a ledger Account.

## Before you start

***

Decide whether the Holder is an **Individual** or **Corporate** record. The type you choose controls which identity and registration fields the form shows.

## Create the Holder

***

<Steps>
  <Step>
    Go to the **Holders** page. Click the **New Holder** button.
  </Step>

  <Step>
    A window opens. Choose the Holder type you want to create.

    * If you select **Individual** (Natural Person), the **New Holder** page opens for you to enter the individual's information.
    * If you select **Corporate** (Legal Person), the **New Holder** page opens for you to enter the company's information.
  </Step>

  <Step>
    Follow the on-screen instructions to enter the required information. Click **Create Holder**.
  </Step>

  <Step>
    When the creation succeeds, you see a confirmation message. The list refreshes and shows the new Holder.
  </Step>
</Steps>

## Field guide

***

### Individual

**Basic Information**

| Field       | What to enter                                                                   | Example          |
| ----------- | ------------------------------------------------------------------------------- | ---------------- |
| External ID | Optional ID from your CRM, core banking, KYC, or customer system.               | `customer_123`   |
| Holder type | A read-only field that indicates the type of Holder.                            | `Natural Person` |
| Name        | The full name of the Holder.                                                    | `John Doe`       |
| Document    | Tax ID, national ID, or company registration number expected by your operation. | `12345678900`    |

**Contact Information**

| Field           | What to enter                                                              | Example                 |
| --------------- | -------------------------------------------------------------------------- | ----------------------- |
| Primary Email   | The main email used to contact the Holder.                                 | `john.doe@example.com`  |
| Secondary Email | An alternative email used to contact the Holder.                           | `john.doe2@example.com` |
| Mobile Phone    | Contact phone number, including country or area code when required.        | `+5511999999999`        |
| Other Phone     | An alternative phone number, including country or area code when required. | `+551188888888`         |

**Addresses**

| Field          | What to enter                                                  | Example           |
| -------------- | -------------------------------------------------------------- | ----------------- |
| Address Line 1 | Street name and building number.                               | `Rua Botucatu 10` |
| Address Line 2 | Extra address details, for example, apartment or suite number. | `Casa B`          |
| Zip Code       | Postal or ZIP code.                                            | `04023060`        |
| City           | City where the address is located.                             | `São Paulo`       |
| State          | State, province, or region.                                    | `SP`              |
| Country        | Two-letter country code (ISO 3166-1 alpha-2).                  | `BR`              |

**Personal Details**

| Field         | What to enter                                             | Example       |
| ------------- | --------------------------------------------------------- | ------------- |
| Favorite Name | Nickname or preferred name.                               | `Johnny`      |
| Social Name   | Social name, if different from the legal name.            | `Johnny Doe`  |
| Gender        | Gender identity of the person.                            | `Male`        |
| Birth Date    | Date of birth in YYYY-MM-DD format.                       | `1990-01-01`  |
| Civil Status  | Civil status — for example: Single, Married, or Divorced. | `Married`     |
| Nationality   | Nationality, for example, Brazilian.                      | `Brazilian`   |
| Mother's Name | Mother's full name.                                       | `Jane Doe`    |
| Father's Name | Father's full name.                                       | `Richard Doe` |
| Status        | Current status of the individual in the system.           | `Active`      |

**Metadata**

| Field | What to enter                                      | Example     |
| ----- | -------------------------------------------------- | ----------- |
| Key   | Optional classification or integration field name. | `kycStatus` |
| Value | Value for the metadata key.                        | `approved`  |

### Corporate

**Basic Information**

| Field       | What to enter                                                                   | Example          |
| ----------- | ------------------------------------------------------------------------------- | ---------------- |
| External ID | Optional ID from your CRM, core banking, KYC, or customer system.               | `company_123`    |
| Type        | A read-only field that indicates the type of Holder.                            | `Legal Person`   |
| Name        | The name of the company in the system.                                          | `ACME`           |
| Document    | Tax ID, national ID, or company registration number expected by your operation. | `59014899000183` |

**Contact Information**

| Field           | What to enter                                                              | Example             |
| --------------- | -------------------------------------------------------------------------- | ------------------- |
| Primary Email   | The main email used to contact the company.                                | `acme@example.com`  |
| Secondary Email | An alternative email used to contact the Holder.                           | `acme2@example.com` |
| Mobile Phone    | Contact phone number, including country or area code when required.        | `+5511999999999`    |
| Other Phone     | An alternative phone number, including country or area code when required. | `+551188888888`     |

**Addresses**

| Field          | What to enter                                                  | Example         |
| -------------- | -------------------------------------------------------------- | --------------- |
| Address Line 1 | Street name and building number.                               | `Rua Silva 100` |
| Address Line 2 | Extra address details, for example, apartment or suite number. | `Cj 12`         |
| Zip Code       | Postal or ZIP code.                                            | `04013060`      |
| City           | City where the address is located.                             | `São Paulo`     |
| State          | State, province, or region.                                    | `SP`            |
| Country        | Two-letter country code (ISO 3166-1 alpha-2).                  | `BR`            |

**Company Details**

| Field                   | What to enter                                                    | Example                          |
| ----------------------- | ---------------------------------------------------------------- | -------------------------------- |
| Trade Name              | The registered business name of the company, if applicable.      | `ACME BR`                        |
| Activity                | The type of business or activity the company engages in.         | `Electronic devices development` |
| Legal Type              | The legal structure of the company.                              | `Limited Liability`              |
| Founding Date           | The date when the company was established, in YYYY-MM-DD format. | `2025-01-01`                     |
| Company Size            | The size classification of the company.                          | `Medium`                         |
| Status                  | Current status of the company in the system.                     | `Active`                         |
| Representative Name     | The legal representative's name.                                 | `Jane Doe`                       |
| Representative Document | The document number of the legal representative.                 | `43522116992`                    |
| Representative Email    | The email address of the legal representative.                   | `janedoe@corporate.com`          |
| Role                    | The role of the legal representative within the company.         | `CFO`                            |

**Metadata**

| Field | What to enter                                      | Example     |
| ----- | -------------------------------------------------- | ----------- |
| Key   | Optional classification or integration field name. | `kycStatus` |
| Value | Value for the metadata key.                        | `approved`  |

## What to do next

***

After you create the Holder, create an Alias Account to connect the Holder to a Midaz ledger Account. See [Creating an Alias Account](/en/midaz/console/crm-creating-alias-account).

<Card title="API equivalent" type="tip" horizontal>
  [Create Holder endpoint](/en/reference/midaz/crm/create-holder)
</Card>
