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

> Create, edit, and delete Holders in the CRM to manage the people and entities that own your Accounts.

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

## What are Holders?

***

A **Holder** represents individuals (Natural Person) or companies (Legal Person) associated with your Midaz accounts. Each holder stores:

* **Identity information** - Name, document number (CPF/CNPJ), and lifecycle 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

Holders are managed in the CRM module and connect to ledger accounts through Alias Accounts, keeping customer data organized separately from transactional operations.

For technical details about CRM, 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 displays a table listing 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/platform/lerian-console/midaz-console/crm-creating-a-holder">
    Add new individuals or companies to your CRM system
  </Card>

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

  <Card title="Delete a Holder" icon="trash" horizontal href="/en/platform/lerian-console/midaz-console/crm-deleting-a-holder">
    Remove holders using soft delete (recoverable) or hard delete (permanent)
  </Card>
</Columns>

## Understanding Holder types

***

When creating a Holder in ,you'll need to select the holder type. This determines which fields and information you can manage:

### Natural Person (Individual)

For individual customers, ther will be 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, country of origin

### Legal Person (Company)

For corporate customers, there will be 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

***

***

The console allows you to manage the holder lifecycle through status changes:

* **ACTIVE** - Holder is operational and can be associated with active accounts
* **INACTIVE** - Holder is temporarily disabled, preserving history while preventing new operations
* **SUSPENDED** - Holder access is restricted, useful for compliance or risk management
* **CLOSED** - Holder relationship is terminated, typically before deletion

<Note>
  Status changes can be made when editing a holder. The current status is always visible in the holders list.
</Note>

## Common use cases

***

<AccordionGroup>
  <Accordion title="Setting up individual customers">
    When onboarding 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">
    When managing 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 External ID field in the console to maintain synchronization:

    * 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 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 when creating. This cannot be changed later and determines available fields in the console forms.
  </Step>

  <Step title="Keep document numbers accurate">
    Document numbers (CPF, CNPJ) must be unique and properly formatted. The console validates format, but ensure accuracy for regulatory compliance.
  </Step>

  <Step title="Maintain updated contact information">
    Regularly update email addresses and phone numbers in the console to ensure effective customer communication.
  </Step>

  <Step title="Use External ID for integration">
    When creating holders, fill in the External ID field to map to your existing customer database for seamless system integration.
  </Step>

  <Step title="Leverage metadata for custom needs">
    Use the Metadata tab in holder forms to store additional information without modifying the core structure.
  </Step>

  <Step title="Manage status transitions properly">
    Use status updates (Active → Suspended → Inactive → Closed) to reflect customer relationship changes before deletion.
  </Step>
</Steps>