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

# Criando um Titular

> Registre um novo Titular no Módulo Midaz para representar a pessoa ou entidade dona de uma ou mais Contas.

Um Titular representa a pessoa ou empresa por trás de uma ou mais Contas. Crie o Titular antes de criar Contas Alias que conectam as informações de conta voltadas ao cliente às Contas do Ledger.

## Antes de começar

***

Decida se o Titular é um registro **Individual** ou **Corporate**. O tipo selecionado controla quais campos de identidade e registro aparecem no formulário.

## Crie o Titular

***

<Steps>
  <Step>
    Acesse a página **Titulares** e clique no botão **Novo Titular**.
  </Step>

  <Step>
    Uma janela será aberta para você escolher o tipo de Titular que deseja criar.

    * Se você selecionar **Individual** (Pessoa Física), será redirecionado para a página **Novo Titular**, onde poderá informar os dados do indivíduo.
    * Se você selecionar **Corporate** (Pessoa Jurídica), será redirecionado para a página **Novo Titular**, onde poderá informar os dados da empresa.
  </Step>

  <Step>
    Siga as instruções na tela para preencher todas as informações necessárias e clique em **Salvar**.
  </Step>

  <Step>
    Se a criação for bem-sucedida, você receberá uma mensagem de confirmação e a lista será atualizada para exibir o novo Titular.
  </Step>
</Steps>

## Guia de campos

***

### Individual (Pessoa Física)

**Informações Básicas**

| Campo           | O que informar                                                    | Exemplo        |
| --------------- | ----------------------------------------------------------------- | -------------- |
| ID Externo      | ID opcional do seu CRM, core banking, KYC ou sistema de clientes. | `customer_123` |
| Tipo de Titular | Campo somente leitura que indica o tipo de Titular.               | `Individual`   |
| Nome            | Nome completo do Titular.                                         | `John Doe`     |
| Documento       | CPF, identificação nacional ou CNPJ exigido pela sua operação.    | `12345678900`  |

**Informações de Contato**

| Campo             | O que informar                                                           | Exemplo                 |
| ----------------- | ------------------------------------------------------------------------ | ----------------------- |
| E-mail Principal  | E-mail principal usado para contatar o Titular.                          | `john.doe@example.com`  |
| E-mail Secundário | E-mail alternativo usado para contatar o Titular.                        | `john.doe2@example.com` |
| Celular           | Telefone de contato, incluindo código de país ou DDD quando necessário.  | `+5511999999999`        |
| Outro Telefone    | Telefone alternativo, incluindo código de país ou DDD quando necessário. | `+551188888888`         |

**Endereços**

| Campo            | O que informar                                                               | Exemplo           |
| ---------------- | ---------------------------------------------------------------------------- | ----------------- |
| Endereço Linha 1 | Nome da rua e número do edifício.                                            | `Rua Botucatu 10` |
| Endereço Linha 2 | Detalhes adicionais do endereço, por exemplo, número do apartamento ou sala. | `Casa B`          |
| CEP              | Código postal ou CEP.                                                        | `04023060`        |
| Cidade           | Cidade onde o endereço está localizado.                                      | `São Paulo`       |
| Estado           | Estado, província ou região.                                                 | `SP`              |
| País             | Código de país de duas letras (ISO 3166-1 alpha-2).                          | `BR`              |

**Dados Pessoais**

| Campo              | O que informar                                              | Exemplo       |
| ------------------ | ----------------------------------------------------------- | ------------- |
| Nome Preferido     | Apelido ou nome preferido.                                  | `Johnny`      |
| Nome Social        | Nome social, se diferente do nome legal.                    | `Johnny Doe`  |
| Gênero             | Identidade de gênero da pessoa.                             | `Male`        |
| Data de Nascimento | Data de nascimento no formato mm/dd/aaaa.                   | `12-01-1990`  |
| Estado Civil       | Estado civil — por exemplo: Solteiro, Casado ou Divorciado. | `Married`     |
| Nacionalidade      | Nacionalidade, por exemplo, brasileira.                     | `Brazilian`   |
| Nome da Mãe        | Nome completo da mãe.                                       | `Jane Doe`    |
| Nome do Pai        | Nome completo do pai.                                       | `Richard Doe` |
| Status             | Status atual da pessoa no sistema.                          | `Active`      |

**Metadados**

| Campo | O que informar                                         | Exemplo     |
| ----- | ------------------------------------------------------ | ----------- |
| Chave | Nome opcional do campo de classificação ou integração. | `kycStatus` |
| Valor | Valor da chave de metadado.                            | `approved`  |

### Empresa (Pessoa Jurídica)

**Informações Básicas**

| Campo      | O que informar                                                    | Exemplo          |
| ---------- | ----------------------------------------------------------------- | ---------------- |
| ID Externo | ID opcional do seu CRM, core banking, KYC ou sistema de clientes. | `company_123`    |
| Tipo       | Campo somente leitura que indica o tipo de Titular.               | `Legal Person`   |
| Nome       | Nome da empresa no sistema.                                       | `ACME`           |
| Documento  | CPF, identificação nacional ou CNPJ exigido pela sua operação.    | `59014899000183` |

**Informações de Contato**

| Campo             | O que informar                                                           | Exemplo             |
| ----------------- | ------------------------------------------------------------------------ | ------------------- |
| E-mail Principal  | E-mail principal usado para contatar a empresa.                          | `acme@example.com`  |
| E-mail Secundário | E-mail alternativo usado para contatar o Titular.                        | `acme2@example.com` |
| Celular           | Telefone de contato, incluindo código de país ou DDD quando necessário.  | `+5511999999999`    |
| Outro Telefone    | Telefone alternativo, incluindo código de país ou DDD quando necessário. | `+551188888888`     |

**Endereços**

| Campo            | O que informar                                                               | Exemplo         |
| ---------------- | ---------------------------------------------------------------------------- | --------------- |
| Endereço Linha 1 | Nome da rua e número do edifício.                                            | `Rua Silva 100` |
| Endereço Linha 2 | Detalhes adicionais do endereço, por exemplo, número do apartamento ou sala. | `Cj 12`         |
| CEP              | Código postal ou CEP.                                                        | `04013060`      |
| Cidade           | Cidade onde o endereço está localizado.                                      | `São Paulo`     |
| Estado           | Estado, província ou região.                                                 | `SP`            |
| País             | Código de país de duas letras (ISO 3166-1 alpha-2).                          | `BR`            |

**Dados Empresariais**

| Campo                      | O que informar                                      | Exemplo                          |
| -------------------------- | --------------------------------------------------- | -------------------------------- |
| Nome Fantasia              | Nome comercial registrado da empresa, se aplicável. | `ACME BR`                        |
| Atividade                  | Tipo de negócio ou atividade que a empresa exerce.  | `Electronic devices development` |
| Tipo Jurídico              | Estrutura jurídica da empresa.                      | `Limited Liability`              |
| Data de Fundação           | Data em que a empresa foi constituída.              | `01-01-2010`                     |
| Porte da Empresa           | Classificação de porte da empresa.                  | `Medium`                         |
| Status                     | Status atual da pessoa no sistema.                  | `Active`                         |
| Nome do Representante      | Nome do representante legal.                        | `Jane Doe`                       |
| Documento do Representante | Número do documento do representante legal.         | `43522116992`                    |
| E-mail do Representante    | Endereço de e-mail do representante legal.          | `janedoe@corporate.com`          |
| Cargo                      | Cargo do representante legal dentro da empresa.     | `CFO`                            |

**Metadados**

| Campo | O que informar                                         | Exemplo     |
| ----- | ------------------------------------------------------ | ----------- |
| Chave | Nome opcional do campo de classificação ou integração. | `kycStatus` |
| Valor | Valor da chave de metadado.                            | `approved`  |

## Próximos passos

***

Após criar o Titular, crie uma Conta Alias para conectar o Titular a uma Conta do Ledger do Midaz em [Criando uma Conta Alias](/pt/lerian-console/midaz-console/crm-creating-alias-account).

<Card title="Equivalente na API" type="info" horizontal>
  [Endpoint Criar Titular](/pt/reference/midaz/crm/create-holder)
</Card>
