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

> Crie um novo Titular no Módulo Midaz como um registro Pessoa Física ou Pessoa Jurídica para representar a pessoa ou empresa 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. Uma Conta Alias conecta informações de conta voltadas ao cliente a uma Conta do ledger.

## Antes de começar

***

Decida se o Titular é um registro **Pessoa Física** ou **Pessoa Jurídica**. O tipo escolhido controla quais campos de identidade e registro o formulário mostra.

## Criar o Titular

***

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

  <Step>
    Uma janela abre. Escolha o tipo de Titular que você quer criar.

    * Se você selecionar **Pessoa Física** (Natural Person), a página **Novo Titular** abre para você informar os dados da pessoa física.
    * Se você selecionar **Pessoa Jurídica** (Legal Person), a página **Novo Titular** abre para você informar os dados da empresa.
  </Step>

  <Step>
    Siga as instruções na tela para informar os dados obrigatórios. Clique em **Criar Titular**.
  </Step>

  <Step>
    Quando a criação for bem-sucedida, você vê uma mensagem de confirmação. A lista atualiza e mostra o novo Titular.
  </Step>
</Steps>

## Guia de campos

***

### Pessoa Física

**Informações Básicas**

| Campo           | O que informar                                                                                                                | Exemplo          |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| External ID     | 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.                                                                           | `Natural Person` |
| Nome            | O nome completo do Titular.                                                                                                   | `John Doe`       |
| Documento       | Número de identificação fiscal, documento de identidade nacional ou número de registro de empresa esperado pela sua operação. | `12345678900`    |

**Informações de Contato**

| Campo             | O que informar                                                                        | Exemplo                 |
| ----------------- | ------------------------------------------------------------------------------------- | ----------------------- |
| E-mail Principal  | O e-mail principal usado para contatar o Titular.                                     | `john.doe@example.com`  |
| E-mail Secundário | Um e-mail alternativo usado para contatar o Titular.                                  | `john.doe2@example.com` |
| Telefone Celular  | Número de telefone de contato, incluindo código de país ou DDD quando necessário.     | `+5511999999999`        |
| Outro Telefone    | Um número de 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 prédio.                                          | `Rua Botucatu 10` |
| Endereço Linha 2 | Detalhes extras do endereço, por exemplo, número de 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`              |

**Detalhes 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 YYYY-MM-DD.                            | `1990-01-01`  |
| Estado Civil       | Estado civil — por exemplo: Solteiro(a), Casado(a) ou Divorciado(a). | `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 física no sistema.                            | `Active`      |

**Metadados**

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

### Pessoa Jurídica

**Informações Básicas**

| Campo       | O que informar                                                                                                                | Exemplo          |
| ----------- | ----------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| External ID | 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        | O nome da empresa no sistema.                                                                                                 | `ACME`           |
| Documento   | Número de identificação fiscal, documento de identidade nacional ou número de registro de empresa esperado pela sua operação. | `59014899000183` |

**Informações de Contato**

| Campo             | O que informar                                                                        | Exemplo             |
| ----------------- | ------------------------------------------------------------------------------------- | ------------------- |
| E-mail Principal  | O e-mail principal usado para contatar a empresa.                                     | `acme@example.com`  |
| E-mail Secundário | Um e-mail alternativo usado para contatar o Titular.                                  | `acme2@example.com` |
| Telefone Celular  | Número de telefone de contato, incluindo código de país ou DDD quando necessário.     | `+5511999999999`    |
| Outro Telefone    | Um número de 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 prédio.                                          | `Rua Silva 100` |
| Endereço Linha 2 | Detalhes extras do endereço, por exemplo, número de 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`            |

**Detalhes da Empresa**

| Campo                      | O que informar                                             | Exemplo                          |
| -------------------------- | ---------------------------------------------------------- | -------------------------------- |
| Nome Fantasia              | O nome comercial registrado da empresa, se aplicável.      | `ACME BR`                        |
| Atividade                  | O tipo de negócio ou atividade que a empresa exerce.       | `Electronic devices development` |
| Tipo Jurídico              | A estrutura jurídica da empresa.                           | `Limited Liability`              |
| Data de Fundação           | A data em que a empresa foi criada, no formato YYYY-MM-DD. | `2025-01-01`                     |
| Porte da Empresa           | A classificação de porte da empresa.                       | `Medium`                         |
| Status                     | Status atual da empresa no sistema.                        | `Active`                         |
| Nome do Representante      | O nome do representante legal.                             | `Jane Doe`                       |
| Documento do Representante | O número do documento do representante legal.              | `43522116992`                    |
| E-mail do Representante    | O endereço de e-mail do representante legal.               | `janedoe@corporate.com`          |
| Papel                      | O papel do representante legal dentro da empresa.          | `CFO`                            |

**Metadados**

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

## Próximos passos

***

Depois de criar o Titular, crie uma Conta Alias para conectar o Titular a uma Conta do ledger Midaz. Veja [Criando uma Conta Alias](/pt/products/midaz/console/crm-creating-alias-account).

<Card title="Equivalente de API" type="tip" horizontal>
  [Endpoint para criar Titular](/pt/reference/products/midaz/v2/create-holder)
</Card>
