API Docs Início Documentação Referência de API Copiar para LLM
POST/v1/NaturalPerson
Crédito · Pessoas

Insere uma nova pessoa física

Cria um novo registro de Natural Person.

Visão geral

Insere uma nova pessoa física. Caso já exista um cadastro existente da PF visível ao operador solicitante (com base no CPF), os dados existentes serão atualizados e o ID retornado será o do registro existente. Coleções relacionadas serão combinadas (dados bancários, documentos, etc).

Autenticação e pré-requisitos

Requer autenticação. Envie o token no header Authorization: Bearer {{token}} (JWT do AWS Cognito). Integrações servidor-a-servidor podem usar X-Api-Key. Todo tráfego é HTTPS e a credencial nunca vai na URL nem em query string.

Request

Parâmetros

NomeEmTipoObrigatórioDescriçãoExemplo
returnValuequerystringopcional—valor

Corpo da requisição

Envie no formato application/json. Corpo opcional.

Campos

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
registrationNumberstringobrigatórioCPF da Pessoa—"12345678910"
phonestringobrigatórioNúmero de Telefone principal—"11912344321"
phoneExtensionstringopcionalRamal do telefone principal—"1234"
emailstringobrigatórioEmail—"teste@teste.com"
namestringobrigatórioNome completo—"Jo\u00E3o da Silva"
nationalitystringopcionalNacionalidade—"Brasileira"
pepbooleanopcionalPessoa politicamente exposta—true
addressobjetoopcional—objeto — ver detalhe abaixo{ … }
birthDatestring (date-time)opcionalData de nascimento—"2000-01-01"
civilStatusstringopcional—Married, Widowed, Separated, Divorced, Single"Married"
genderstringopcional—NotInformed, Male, Female"NotInformed"
documentTypestringopcional—RG, CPF, CNH, CTPS"RG"
documentNumberstringopcionalNúmero de documento de identificação—"texto"
documentIssuerstringopcionalEmissor do documento de identificação—"texto"
documentDatestring (date-time)opcionalData de emissão do documento de identificação—"2025-08-11T13:45:00Z"
documentExpirationstring (date-time)opcionalData de expiração do documento de identificação—"2025-08-11T13:45:00Z"
phone2stringopcionalTelefone alternativo—"11987654321"
phone2ExtensionstringopcionalRamal do número de telefone alternativo—"11987654321"
mothersNamestringopcionalNome completo da mãe—"Fulano de Tal"
fathersNamestringopcionalNome completo do pai—"Fulano de Tal"
placeOfBirthCountrystringopcionalNacionalidade—"texto"
placeOfBirthStatestringopcionalNaturalidade—"texto"
typeOfResidencestringopcional—Owner, Rent"Owner"
between7And15YearsOldintegeropcionalDependentes de 7 a 15 anos de idade—0
upTo6YearsOldintegeropcionalDependentes de até 6 anos de idade—0
over15YearsOldintegeropcionalDependentes com mais de 15 anos de idade—0
workplacestringopcionalEmpresa em que trabalha—"texto"
workplaceCompanyRegistrationNumberstringopcionalCNPJ da empresa em que trabalha—"texto"
employeeNumberstringopcionalMatricula do funcionario na empresa em que trabalha—"texto"
occupationstringopcionalOcupação—"texto"
natureOfOccupationstringopcional—PrivateEmployee, PublicEmployee, Employer, Capitalist, Military, Autonomous, Other"PrivateEmployee"
commercialPhonestringopcionalTelefone comercial—"11987654321"
commercialPhoneExtensionstringopcionalRamal do telefone comercial—"11987654321"
netSalarynumber (double)opcionalSalário líquido (em centavos)—1000
otherIncomenumber (double)opcionalOutras receitas (em centavos)—1000
admissionDatestring (date-time)opcionalData de admissão—"2025-08-11T13:45:00Z"
commercialPhone2stringopcionalTelefone comercial alternativo—"11987654321"
commercialPhone2ExtensionstringopcionalRamal do telefone comercial alternativo—"11987654321"
commercialAddressobjetoopcional—objeto — ver detalhe abaixo{ … }
economicActivityCodeIdstring (uuid)opcionalID de referência do registro de atividade econômica (CNAE)—"3fa85f64-5717-4562-b3fc-2c963f66afa6"
spouseIndividualRegistrationNumberstringopcionalNúmero de CPF do cônjuge—"texto"
spouseDocumentTypestringopcional—RG, CPF, CNH, CTPS"RG"
spouseDocumentNumberstringopcionalNúmero de documento de identificação do cônjuge—"texto"
spouseDocumentIssuerstringopcionalEmissor do documento de identificação do cônjuge—"texto"
spouseDocumentDatestring (date-time)opcionalData de emissão do documento de identificação do cônjuge—"2025-08-11T13:45:00Z"
spouseDocumentExpirationstring (date-time)opcionalData de expiração do documento de identificação do cônjuge—"2025-08-11T13:45:00Z"
spouseNamestringopcionalNome completo do cônjuge—"Fulano de Tal"
spouseWorkplacestringopcionalLocal de trabalho do cônjuge—"texto"
spouseOccupationstringopcionalOcupação do cônjuge—"texto"
spouseCommercialPhonestringopcionalTelefone comercial do cônjuge—"11987654321"
spouseCommercialPhoneExtensionstringopcionalRamal do telefone comercial do cônjuge—"11987654321"
spouseBirthDatestring (date-time)opcionalData de nascimento do cônjuge—"2025-08-11T13:45:00Z"
spouseNetSalarynumber (double)opcionalSalário líquido do cônjuge—1000
spouseOtherIncomenumber (double)opcionalOutras receitas do cônjuge—1000
assetsarray de objetoopcionalLista de bens e direitosobjeto — ver detalhe abaixo[ … ]
allowContactWhatsAppbooleanopcionalPermitir contato via Whatsapp—true
allowUpdatesWhatsAppbooleanopcionalPermitir notificações via Whatsapp—true
uploadsarray de objetoopcionalLista de documentos carregadosobjeto — ver detalhe abaixo[ … ]
bankAccountsarray de objetoopcionalLista de contas bancáriasobjeto — ver detalhe abaixo[ … ]
riskRatingstringopcional—Low, Intermediary, High"Low"
healthDeclarationstringopcionalDeclaração de Saúde—"texto"
departmentstringopcionalDepartamento—"texto"
socialNamestringopcionalNome Social—"Fulano de Tal"

Detalhe de ownerUser

CampoTipoObrigatórioDescriçãoValoresExemplo
userIdstringobrigatório——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
tenantNamestringobrigatório——"Fulano de Tal"

Detalhe de ownerGroup

CampoTipoObrigatórioDescriçãoValoresExemplo
groupIdstringobrigatório——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
tenantNamestringobrigatório——"Fulano de Tal"

Detalhe de address

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
addressNamestringobrigatório——"Fulano de Tal"
zipCodestringopcional——"01310930"
citystringobrigatório——"texto"
ufstringopcional—NaoSelecionado, AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG +14"NaoSelecionado"
districtstringobrigatório——"texto"
numberstringopcionalNúmero do endereço deve conter apenas números—"texto"
complementstringopcional——"texto"

Detalhe de assets

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
naturalPersonIdstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
legalPersonIdstring (uuid)opcional——"3fa85f64-5717-4562-b3fc-2c963f66afa6"
assetTypestringobrigatório—Cash, AccountsReceivable, Inventory, Investments, Vehicles, Furniture, Patents, RealEstate"Cash"
descriptionstringopcional——"texto"
registerNumberstringopcional——"texto"
estimatedValuenumber (double)opcional——1000
settledbooleanopcional——true

Detalhe de uploads

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
fileTypestringobrigatório—Document, Authorization, DriversLicense, WorkCard, ResidenceProofCompany, ResidenceProofPartners, Draft, SocialContract, RegistrationNumber, IdentificationDocumentWithPhoto, BankStatement, ManagerialBilling, RegistrationForm, Others +41"Document"
fileNamestringobrigatórioNome do arquivo (retornado pelo GET v1/Upload)—"Fulano de Tal"
displayNamestringopcionalNome de exibição do arquivo—"Fulano de Tal"
documentDatestring (date-time)opcionalData do próprio documento (emissão/referência), não a data do upload. Aceita em qualquer tipo de documento e sempre opcional. Só tem efeito de negócio no laudo de deferimento INSS e na última perícia INSS, cujos valores são comparados aos cortes da regra de elegibilidade dos benefícios 32/92 (faixa 45–54); nos demais tipos é apenas informativa.—"2025-08-11T13:45:00Z"

Detalhe de bankAccounts

CampoTipoObrigatórioDescriçãoValoresExemplo
ownerUserobjetoopcional—objeto — ver detalhe abaixo{ … }
ownerGroupobjetoopcional—objeto — ver detalhe abaixo{ … }
bankCodeintegeropcional——0
bankIspbinteger (int64)opcionalCódigo ISPB do banco—0
accountstringopcional——"texto"
accountDigitstringopcional——"texto"
agencystringopcional——"texto"
agencyDigitstringopcional——"texto"
typestringopcional—NaturalCheckingAccount, NaturalSimpleAccount, LegalCheckingAccount, PublicEntities, FinancialInstitutionsDeposits, NaturalSavingsAccount, LegalSavingsAccount, RealEstateSavingsAccount, LotteryDeposits, EscrowAccount"NaturalCheckingAccount"
jointAccountbooleanopcional——true
operationTypeValuestringobrigatório—Transfer, Pix"Transfer"
pixKeyTypeValuestringopcional—NaturalRegistrationNumber, LegalRegistrationNumber, Phone, Email, Automatic, AgencyAndAccount"NaturalRegistrationNumber"
keyPixstringopcionalchave pix—"texto"

Exemplo de corpo

{
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "registrationNumber": "12345678910",
  "phone": "11912344321",
  "phoneExtension": "1234",
  "email": "teste@teste.com",
  "name": "Jo\u00E3o da Silva",
  "nationality": "Brasileira",
  "pep": true,
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "birthDate": "2000-01-01",
  "civilStatus": "Married",
  "gender": "NotInformed",
  "documentType": "RG",
  "documentNumber": "texto",
  "documentIssuer": "texto",
  "documentDate": "2025-08-11T13:45:00Z",
  "documentExpiration": "2025-08-11T13:45:00Z",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "mothersName": "Fulano de Tal",
  "fathersName": "Fulano de Tal",
  "placeOfBirthCountry": "texto",
  "placeOfBirthState": "texto",
  "typeOfResidence": "Owner",
  "between7And15YearsOld": 0,
  "upTo6YearsOld": 0,
  "over15YearsOld": 0,
  "workplace": "texto",
  "workplaceCompanyRegistrationNumber": "texto",
  "employeeNumber": "texto",
  "occupation": "texto",
  "natureOfOccupation": "PrivateEmployee",
  "commercialPhone": "11987654321",
  "commercialPhoneExtension": "11987654321",
  "netSalary": 1000,
  "otherIncome": 1000,
  "admissionDate": "2025-08-11T13:45:00Z",
  "commercialPhone2": "11987654321",
  "commercialPhone2Extension": "11987654321",
  "commercialAddress": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "spouseIndividualRegistrationNumber": "texto",
  "spouseDocumentType": "RG",
  "spouseDocumentNumber": "texto",
  "spouseDocumentIssuer": "texto",
  "spouseDocumentDate": "2025-08-11T13:45:00Z",
  "spouseDocumentExpiration": "2025-08-11T13:45:00Z",
  "spouseName": "Fulano de Tal",
  "spouseWorkplace": "texto",
  "spouseOccupation": "texto",
  "spouseCommercialPhone": "11987654321",
  "spouseCommercialPhoneExtension": "11987654321",
  "spouseBirthDate": "2025-08-11T13:45:00Z",
  "spouseNetSalary": 1000,
  "spouseOtherIncome": 1000,
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "naturalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "allowContactWhatsApp": true,
  "allowUpdatesWhatsApp": true,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "fileType": "Document",
      "fileName": "Fulano de Tal",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "riskRating": "Low",
  "healthDeclaration": "texto",
  "department": "texto",
  "socialName": "Fulano de Tal"
}

Response

Resposta 200.

Sem campos estruturados no contrato (tipo primitivo ou livre).

Exemplo de resposta

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Códigos de retorno

CódigoSignificadoDetalhe do contrato
200Requisição bem-sucedida.Success

Exemplos

curl -X POST "{{baseUrl}}/v1/NaturalPerson" \
  -H "Authorization: Bearer {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "registrationNumber": "12345678910",
  "phone": "11912344321",
  "phoneExtension": "1234",
  "email": "teste@teste.com",
  "name": "Jo\u00E3o da Silva",
  "nationality": "Brasileira",
  "pep": true,
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "birthDate": "2000-01-01",
  "civilStatus": "Married",
  "gender": "NotInformed",
  "documentType": "RG",
  "documentNumber": "texto",
  "documentIssuer": "texto",
  "documentDate": "2025-08-11T13:45:00Z",
  "documentExpiration": "2025-08-11T13:45:00Z",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "mothersName": "Fulano de Tal",
  "fathersName": "Fulano de Tal",
  "placeOfBirthCountry": "texto",
  "placeOfBirthState": "texto",
  "typeOfResidence": "Owner",
  "between7And15YearsOld": 0,
  "upTo6YearsOld": 0,
  "over15YearsOld": 0,
  "workplace": "texto",
  "workplaceCompanyRegistrationNumber": "texto",
  "employeeNumber": "texto",
  "occupation": "texto",
  "natureOfOccupation": "PrivateEmployee",
  "commercialPhone": "11987654321",
  "commercialPhoneExtension": "11987654321",
  "netSalary": 1000,
  "otherIncome": 1000,
  "admissionDate": "2025-08-11T13:45:00Z",
  "commercialPhone2": "11987654321",
  "commercialPhone2Extension": "11987654321",
  "commercialAddress": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "spouseIndividualRegistrationNumber": "texto",
  "spouseDocumentType": "RG",
  "spouseDocumentNumber": "texto",
  "spouseDocumentIssuer": "texto",
  "spouseDocumentDate": "2025-08-11T13:45:00Z",
  "spouseDocumentExpiration": "2025-08-11T13:45:00Z",
  "spouseName": "Fulano de Tal",
  "spouseWorkplace": "texto",
  "spouseOccupation": "texto",
  "spouseCommercialPhone": "11987654321",
  "spouseCommercialPhoneExtension": "11987654321",
  "spouseBirthDate": "2025-08-11T13:45:00Z",
  "spouseNetSalary": 1000,
  "spouseOtherIncome": 1000,
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "naturalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "allowContactWhatsApp": true,
  "allowUpdatesWhatsApp": true,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "fileType": "Document",
      "fileName": "Fulano de Tal",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "riskRating": "Low",
  "healthDeclaration": "texto",
  "department": "texto",
  "socialName": "Fulano de Tal"
}'
var baseUrl = "{{baseUrl}}";
var token   = "{{token}}";

using var http = new HttpClient { BaseAddress = new Uri(baseUrl) };
http.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", token);

var rota = "/v1/NaturalPerson";

var corpo = new StringContent(
    """
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "registrationNumber": "12345678910",
      "phone": "11912344321",
      "phoneExtension": "1234",
      "email": "teste@teste.com",
      "name": "Jo\u00E3o da Silva",
      "nationality": "Brasileira",
      "pep": true,
      "address": {
        "ownerUser": {
          "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "ownerGroup": {
          "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "addressName": "Fulano de Tal",
        "zipCode": "01310930",
        "city": "texto",
        "uf": "NaoSelecionado",
        "district": "texto",
        "number": "texto",
        "complement": "texto"
      },
      "birthDate": "2000-01-01",
      "civilStatus": "Married",
      "gender": "NotInformed",
      "documentType": "RG",
      "documentNumber": "texto",
      "documentIssuer": "texto",
      "documentDate": "2025-08-11T13:45:00Z",
      "documentExpiration": "2025-08-11T13:45:00Z",
      "phone2": "11987654321",
      "phone2Extension": "11987654321",
      "mothersName": "Fulano de Tal",
      "fathersName": "Fulano de Tal",
      "placeOfBirthCountry": "texto",
      "placeOfBirthState": "texto",
      "typeOfResidence": "Owner",
      "between7And15YearsOld": 0,
      "upTo6YearsOld": 0,
      "over15YearsOld": 0,
      "workplace": "texto",
      "workplaceCompanyRegistrationNumber": "texto",
      "employeeNumber": "texto",
      "occupation": "texto",
      "natureOfOccupation": "PrivateEmployee",
      "commercialPhone": "11987654321",
      "commercialPhoneExtension": "11987654321",
      "netSalary": 1000,
      "otherIncome": 1000,
      "admissionDate": "2025-08-11T13:45:00Z",
      "commercialPhone2": "11987654321",
      "commercialPhone2Extension": "11987654321",
      "commercialAddress": {
        "ownerUser": {
          "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "ownerGroup": {
          "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "tenantName": "Fulano de Tal"
        },
        "addressName": "Fulano de Tal",
        "zipCode": "01310930",
        "city": "texto",
        "uf": "NaoSelecionado",
        "district": "texto",
        "number": "texto",
        "complement": "texto"
      },
      "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "spouseIndividualRegistrationNumber": "texto",
      "spouseDocumentType": "RG",
      "spouseDocumentNumber": "texto",
      "spouseDocumentIssuer": "texto",
      "spouseDocumentDate": "2025-08-11T13:45:00Z",
      "spouseDocumentExpiration": "2025-08-11T13:45:00Z",
      "spouseName": "Fulano de Tal",
      "spouseWorkplace": "texto",
      "spouseOccupation": "texto",
      "spouseCommercialPhone": "11987654321",
      "spouseCommercialPhoneExtension": "11987654321",
      "spouseBirthDate": "2025-08-11T13:45:00Z",
      "spouseNetSalary": 1000,
      "spouseOtherIncome": 1000,
      "assets": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "naturalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
          "assetType": "Cash",
          "description": "texto",
          "registerNumber": "texto",
          "estimatedValue": 1000,
          "settled": true
        }
      ],
      "allowContactWhatsApp": true,
      "allowUpdatesWhatsApp": true,
      "uploads": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "fileType": "Document",
          "fileName": "Fulano de Tal",
          "displayName": "Fulano de Tal",
          "documentDate": "2025-08-11T13:45:00Z"
        }
      ],
      "bankAccounts": [
        {
          "ownerUser": {
            "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "ownerGroup": {
            "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
            "tenantName": "Fulano de Tal"
          },
          "bankCode": 0,
          "bankIspb": 0,
          "account": "texto",
          "accountDigit": "texto",
          "agency": "texto",
          "agencyDigit": "texto",
          "type": "NaturalCheckingAccount",
          "jointAccount": true,
          "operationTypeValue": "Transfer",
          "pixKeyTypeValue": "NaturalRegistrationNumber",
          "keyPix": "texto"
        }
      ],
      "riskRating": "Low",
      "healthDeclaration": "texto",
      "department": "texto",
      "socialName": "Fulano de Tal"
    }
    """,
    Encoding.UTF8, "application/json");

var resp = await http.PostAsync(rota, corpo);
resp.EnsureSuccessStatusCode();
var json = await resp.Content.ReadAsStringAsync();
const baseUrl = '{{baseUrl}}';
const token   = '{{token}}';

const payload = {
  "ownerUser": {
    "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "ownerGroup": {
    "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "tenantName": "Fulano de Tal"
  },
  "registrationNumber": "12345678910",
  "phone": "11912344321",
  "phoneExtension": "1234",
  "email": "teste@teste.com",
  "name": "Jo\u00E3o da Silva",
  "nationality": "Brasileira",
  "pep": true,
  "address": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "birthDate": "2000-01-01",
  "civilStatus": "Married",
  "gender": "NotInformed",
  "documentType": "RG",
  "documentNumber": "texto",
  "documentIssuer": "texto",
  "documentDate": "2025-08-11T13:45:00Z",
  "documentExpiration": "2025-08-11T13:45:00Z",
  "phone2": "11987654321",
  "phone2Extension": "11987654321",
  "mothersName": "Fulano de Tal",
  "fathersName": "Fulano de Tal",
  "placeOfBirthCountry": "texto",
  "placeOfBirthState": "texto",
  "typeOfResidence": "Owner",
  "between7And15YearsOld": 0,
  "upTo6YearsOld": 0,
  "over15YearsOld": 0,
  "workplace": "texto",
  "workplaceCompanyRegistrationNumber": "texto",
  "employeeNumber": "texto",
  "occupation": "texto",
  "natureOfOccupation": "PrivateEmployee",
  "commercialPhone": "11987654321",
  "commercialPhoneExtension": "11987654321",
  "netSalary": 1000,
  "otherIncome": 1000,
  "admissionDate": "2025-08-11T13:45:00Z",
  "commercialPhone2": "11987654321",
  "commercialPhone2Extension": "11987654321",
  "commercialAddress": {
    "ownerUser": {
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "ownerGroup": {
      "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "tenantName": "Fulano de Tal"
    },
    "addressName": "Fulano de Tal",
    "zipCode": "01310930",
    "city": "texto",
    "uf": "NaoSelecionado",
    "district": "texto",
    "number": "texto",
    "complement": "texto"
  },
  "economicActivityCodeId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "spouseIndividualRegistrationNumber": "texto",
  "spouseDocumentType": "RG",
  "spouseDocumentNumber": "texto",
  "spouseDocumentIssuer": "texto",
  "spouseDocumentDate": "2025-08-11T13:45:00Z",
  "spouseDocumentExpiration": "2025-08-11T13:45:00Z",
  "spouseName": "Fulano de Tal",
  "spouseWorkplace": "texto",
  "spouseOccupation": "texto",
  "spouseCommercialPhone": "11987654321",
  "spouseCommercialPhoneExtension": "11987654321",
  "spouseBirthDate": "2025-08-11T13:45:00Z",
  "spouseNetSalary": 1000,
  "spouseOtherIncome": 1000,
  "assets": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "naturalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "legalPersonId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "assetType": "Cash",
      "description": "texto",
      "registerNumber": "texto",
      "estimatedValue": 1000,
      "settled": true
    }
  ],
  "allowContactWhatsApp": true,
  "allowUpdatesWhatsApp": true,
  "uploads": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "fileType": "Document",
      "fileName": "Fulano de Tal",
      "displayName": "Fulano de Tal",
      "documentDate": "2025-08-11T13:45:00Z"
    }
  ],
  "bankAccounts": [
    {
      "ownerUser": {
        "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "ownerGroup": {
        "groupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "tenantName": "Fulano de Tal"
      },
      "bankCode": 0,
      "bankIspb": 0,
      "account": "texto",
      "accountDigit": "texto",
      "agency": "texto",
      "agencyDigit": "texto",
      "type": "NaturalCheckingAccount",
      "jointAccount": true,
      "operationTypeValue": "Transfer",
      "pixKeyTypeValue": "NaturalRegistrationNumber",
      "keyPix": "texto"
    }
  ],
  "riskRating": "Low",
  "healthDeclaration": "texto",
  "department": "texto",
  "socialName": "Fulano de Tal"
};

const resp = await fetch(`${baseUrl}/v1/NaturalPerson`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(payload),
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();

Troque apenas {{baseUrl}} e {{token}}. No Postman, defina-os como variáveis de environment; o cURL importa em Import > Raw text.

Downloads

Este endpoint já vem configurado nas collections abaixo, na pasta da etapa correspondente.

Collection completaConsignado privado e FGTS, em pastas espelhando a documentação.Baixar →Collection do Consignado privadoCadastros, operação e consultas do módulo.Baixar →Collection do FGTSCadastros, operação e consultas do módulo.Baixar →Environment do PostmanAs variáveis fora da collection, para versionar uma sem versionar o token.Baixar →Documentação consolidada para LLMToda a documentação em um arquivo de texto, na ordem da navegação.Baixar →Referência em MarkdownEste contrato, campo a campo, gerado do spec.Baixar →

Guia de importação: Como importar no Postman · Todos os downloads: Downloads