> ## 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 Individual ou Empresa 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 **Individual** ou **Empresa**. O tipo escolhido controla quais campos de identidade e registro o formulário mostra.

## Criar o Titular

***

**Step 1**

Acesse a página **Titulares**. Clique no botão **Novo Titular**.

**Step 2**

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

* Se você selecionar **Individual** (Pessoa física), a página **Novo Titular** abre para você informar os dados da pessoa física.
* Se você selecionar **Empresa** (Pessoa jurídica), a página **Novo Titular** abre para você informar os dados da empresa.

**Step 3**

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

**Step 4**

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

## Guia de campos

***

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

**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 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 |
| - | - | - |
| 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 | 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` |
| 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` |

**Dados Empresariais**

| 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](https://docs.lerian.studio/pt/products/midaz/console/crm-creating-alias-account.md).

> [card] Equivalente de API
>
> [Endpoint para criar Titular](https://docs.lerian.studio/pt/reference/products/midaz/v2/create-holder.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.