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

# Managing Holders

> Manage Holders in the Midaz Module — create, edit, and delete individuals or companies with their identity, contact, and address information.

Use the **Midaz Module** to manage **Holders**. Holders represent the people or organizations behind your accounts. In the console, you create, view, edit, and manage their information.

## What are Holders?

***

A **Holder** represents an individual (Natural Person) or a company (Legal Person) linked to your Midaz accounts. Each holder stores:

* **Identity information** - Name, document number (CPF/CNPJ), and an optional free-text status
* **Contact details** - Email addresses and phone numbers for communication
* **Address information** - Primary and additional addresses with complete location data
* **Person-specific data** - Personal details for individuals or business information for companies
* **Custom metadata** - Additional fields for integration and business-specific needs

You manage Holders in the CRM area of the Midaz Module. Holders connect to ledger accounts through Alias Accounts. This keeps customer data separate from transactional operations.

For technical details about the underlying CRM capabilities, refer to the [CRM Overview](/en/midaz/crm/crm-overview) page.

## Accessing the Holders page

***

To open the **Holders** page, select the **Holders** option from the Accounts section of the left-side menu.

The **Holders** page shows a table with all Holders in your system.

### Available actions

From the **Holders** page, you can:

<Columns cols={2}>
  <Card title="Create a Holder" icon="plus" horizontal href="/en/midaz/console/crm-creating-a-holder">
    Add new individuals or companies as Holders
  </Card>

  <Card title="Edit a Holder" icon="pen" horizontal href="/en/midaz/console/crm-editing-a-holder">
    Update holder information, contact details, and status
  </Card>

  <Card title="Delete a Holder" icon="trash" horizontal href="/en/midaz/console/crm-deleting-a-holder">
    Remove holders (soft delete). Hard delete is available only through the API (`?hard_delete=true`)
  </Card>
</Columns>

## Understanding Holder types

***

When you create a Holder, you select the holder type. The type determines which fields you can manage:

### Natural Person (Individual)

For individual customers, the console shows fields for:

* **Basic information**: Full name, document (CPF), contact details
* **Personal details**: Favorite name, social name, gender, birth date
* **Family information**: Civil status, mother's name, father's name
* **Demographics**: Nationality

### Legal Person (Company)

For corporate customers, the console shows fields for:

* **Basic information**: Company name, document (CNPJ), contact details
* **Business details**: Trade name, company activity, founding date
* **Structure**: Company size, company type, business status
* **Legal representation**: Representative name, document, role, contact

## Managing Holder status

***

**Status** is an optional free-text field on the holder form. Use it to record any classification your business needs, such as `active` or `under-review`.

<Note>
  To change the status, edit the holder. The holders list shows the **Name**, **ID**, **Type**, and **Primary E-mail** columns; open a holder to see its status.
</Note>

## Common use cases

***

<AccordionGroup>
  <Accordion title="Setting up individual customers">
    To onboard individual customers in the console:

    1. Create a Natural Person holder with personal details
    2. Add primary address and contact information
    3. Link to checking/savings accounts via Alias Accounts
    4. Use metadata for customer-specific attributes (loyalty tier, risk profile, etc.)
  </Accordion>

  <Accordion title="Managing business customers">
    To manage corporate accounts in the console:

    1. Create a Legal Person holder with company information
    2. Add legal representative details for compliance
    3. Include business addresses and contact points
    4. Link to corporate treasury and operational accounts
    5. Track company size and activity sector for reporting
  </Accordion>

  <Accordion title="Integrating with external systems">
    Use the External ID field in the console to keep systems in sync:

    * Map each holder to your existing CRM using External ID
    * Keep document numbers consistent across systems
    * Use metadata for integration-specific fields
    * Update status in the console to reflect external system changes
  </Accordion>
</AccordionGroup>

## Best practices

***

<Steps>
  <Step title="Choose the correct holder type at creation">
    Select Natural Person for individuals and Legal Person for companies. You cannot change the type later. The type sets which fields the console forms show.
  </Step>

  <Step title="Keep document numbers accurate">
    Document numbers (CPF, CNPJ) must be unique and correctly formatted. The document field is required, but the console does not validate its format — verify the numbers yourself for regulatory compliance.
  </Step>

  <Step title="Maintain updated contact information">
    Update email addresses and phone numbers in the console regularly. This keeps customer communication effective.
  </Step>

  <Step title="Use External ID for integration">
    When you create a holder, fill in the External ID field. It maps the holder to your existing customer database.
  </Step>

  <Step title="Use metadata for custom needs">
    Use the Metadata step in the holder form to store extra information. You do not change the core structure.
  </Step>

  <Step title="Keep the status field meaningful">
    If you use the optional status field, define a consistent set of values for your team and update it to reflect customer relationship changes before deletion.
  </Step>
</Steps>