1. Proprietário
Homfy Public API
  • Bem vindo
  • Autenticação
    • Emitir token
      POST
    • Renovar token
      POST
  • Empreendimento
    • Cadastrar empreendimento
      POST
    • Atualizar empreendimento
      PUT
    • Cadastrar empreendimentos em lote
      POST
    • Consultar empreendimento
      POST
    • Vincular imóveis ao empreendimento
      POST
  • Imóvel
    • Cadastrar imóvel
      POST
    • Atualizar imóvel
      PUT
    • Cadastrar imóveis em lote
      POST
    • Consultar detalhes do imóvel
      POST
    • Enviar fotos — passo 1: obter URLs
      POST
    • Enviar fotos — passo 2: concluir
      POST
    • Andamento do processamento das fotos
      POST
    • Enviar documento — passo 1: obter URL
      POST
    • Enviar documento — passo 2: concluir
      POST
    • Buscar imóveis
      POST
  • Proprietário
    • Cadastrar proprietário
      POST
    • Atualizar proprietário
      PUT
    • Cadastrar proprietários em lote
      POST
    • Consultar detalhes do proprietário
      POST
    • Buscar proprietários
      POST
    • Vincular proprietário a imóvel
      POST
  • Cliente
    • Cadastrar cliente
      POST
    • Atualizar cliente
      PUT
    • Cadastrar clientes em lote
      POST
    • Consultar detalhes do cliente
      POST
    • Buscar clientes
      POST
    • Atribuir cliente a corretor
      POST
  • Corretor
    • Consultar corretores
  • Schemas
    • ApiPartnerAuthTokenDTO
    • ApiPartnerAuthTokenResponseDTO
    • ApiPartnerErrorResponseDTO
    • ApiPartnerAuthRefreshTokenDTO
    • ApiPartnerAddressDTO
    • ApiPartnerPropertyDetailDTO
    • ApiPartnerPropertyPriceDTO
    • ApiPartnerPropertyListingDTO
    • ApiPartnerPropertyRegisterDTO
    • ApiPartnerPropertyCreatedDTO
    • ApiPartnerPropertySkippedDTO
    • ApiPartnerPropertyErrorItemDTO
    • ApiPartnerPropertyRegisterResponseDTO
    • ApiPartnerPropertyItemDTO
    • ApiPartnerPropertyBatchRegisterDTO
    • ApiPartnerPropertyUpdateDTO
    • ApiPartnerPropertyUpdateResponseDTO
    • ApiPartnerPropertyFindDTO
    • ApiPartnerListingPriceDTO
    • ApiPartnerListingImageDTO
    • ApiPartnerListingVideoDTO
    • ApiPartnerListingResponseDTO
    • ApiPartnerPropertyDetailResponseDTO
    • ApiPartnerPhotoFileDTO
    • ApiPartnerPhotosInitDTO
    • ApiPartnerPresignedPartDTO
    • ApiPartnerPhotoUploadTargetDTO
    • ApiPartnerPhotosInitResponseDTO
    • ApiPartnerUploadPartDTO
    • ApiPartnerPhotoUploadDTO
    • ApiPartnerPhotosCompleteDTO
    • ApiPartnerPhotoCompleteItemDTO
    • ApiPartnerPhotosCompleteResponseDTO
    • ApiPartnerPhotosStatusDTO
    • ApiPartnerPhotoVariantDTO
    • ApiPartnerPhotoStatusItemDTO
    • ApiPartnerPhotosStatusResponseDTO
    • ApiPartnerDocumentInitDTO
    • ApiPartnerDocumentInitResponseDTO
    • ApiPartnerDocumentCompleteDTO
    • ApiPartnerDocumentCompleteResponseDTO
    • ApiPartnerPropertyFiltroDTO
    • ApiPartnerPropertySearchFiltersDTO
    • ApiPartnerSearchSortDTO
    • ApiPartnerPropertySearchDTO
    • ApiPartnerPropertySummaryDTO
    • ApiPartnerPropertySearchResponseDTO
    • ApiPartnerOwnerSpouseDTO
    • ApiPartnerOwnerRegisterDTO
    • ApiPartnerOwnerCreatedDTO
    • ApiPartnerOwnerSkippedDTO
    • ApiPartnerOwnerErrorItemDTO
    • ApiPartnerOwnerRegisterResponseDTO
    • ApiPartnerOwnerItemDTO
    • ApiPartnerOwnerBatchRegisterDTO
    • ApiPartnerOwnerUpdateDTO
    • ApiPartnerOwnerUpdateResponseDTO
    • ApiPartnerOwnerFindDTO
    • ApiPartnerOwnerSpouseResponseDTO
    • ApiPartnerOwnerDetailResponseDTO
    • ApiPartnerOwnerSearchSortDTO
    • ApiPartnerOwnerSearchFiltersDTO
    • ApiPartnerOwnerSearchDTO
    • ApiPartnerOwnerSummaryDTO
    • ApiPartnerOwnerSearchResponseDTO
    • ApiPartnerOwnerLinkPropertyDTO
    • ApiPartnerOwnerLinkResponseDTO
    • ApiPartnerLeadRegisterDTO
    • ApiPartnerLeadCreatedDTO
    • ApiPartnerLeadSkippedDTO
    • ApiPartnerLeadErrorItemDTO
    • ApiPartnerLeadRegisterResponseDTO
    • ApiPartnerLeadItemDTO
    • ApiPartnerLeadBatchRegisterDTO
    • ApiPartnerLeadUpdateDTO
    • ApiPartnerLeadUpdateResponseDTO
    • ApiPartnerLeadFindDTO
    • ApiPartnerLeadDetailResponseDTO
    • ApiPartnerLeadSearchSortDTO
    • ApiPartnerLeadSearchFiltersDTO
    • ApiPartnerLeadSearchDTO
    • ApiPartnerLeadSummaryDTO
    • ApiPartnerLeadSearchResponseDTO
    • ApiPartnerLeadAssignAgentDTO
    • ApiPartnerLeadAssignAgentResponseDTO
    • ApiPartnerAgentSearchFiltersDTO
    • ApiPartnerAgentSearchDTO
    • ApiPartnerAgentSummaryDTO
    • ApiPartnerAgentSearchResponseDTO
    • ApiPartnerRealtyClusterRegisterDTO
    • ApiPartnerRealtyClusterCreatedDTO
    • ApiPartnerRealtyClusterSkippedDTO
    • ApiPartnerRealtyClusterErrorItemDTO
    • ApiPartnerRealtyClusterRegisterResponseDTO
    • ApiPartnerRealtyClusterItemDTO
    • ApiPartnerRealtyClusterBatchRegisterDTO
    • ApiPartnerRealtyClusterUpdateDTO
    • ApiPartnerRealtyClusterAddressResponseDTO
    • ApiPartnerRealtyClusterDetailResponseDTO
    • ApiPartnerRealtyClusterFindDTO
    • ApiPartnerRealtyClusterLinkPropertiesDTO
    • ApiPartnerRealtyClusterLinkedDTO
    • ApiPartnerRealtyClusterLinkErrorDTO
    • ApiPartnerRealtyClusterLinkResponseDTO
  1. Proprietário

Atualizar proprietário

PUT
/partner/v1/property-owner
Atualização PARCIAL: o que não vier no corpo fica como está. O proprietário é identificado pelo partner_code, que não é alterável.
Trocar WhatsApp, e-mail ou documento por um valor que já pertence a outro proprietário seu é recusado — a unicidade vale também na atualização.
spouse é substituído por inteiro quando enviado.
String vazia ("") APAGA o campo, e vale para phone, notes, os address_* e os campos de qualificação (profession, marital_status, marriage_regime, nationality, rg, rg_issuer, origin). Os quatro campos de identidade recusam "" com 400: name, whatsapp, email e document — o e-mail só pode ser trocado, não removido.
null é recusado em qualquer campo: para não mexer num campo, não o envie.

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/jsonRequired

Example
{
    "document_type": "cpf",
    "birth_date": "1985-03-14",
    "partner_code": "PROP-4471",
    "name": "João da Silva Júnior",
    "whatsapp": "(48) 99999-1234",
    "email": "joao@exemplo.com",
    "phone": "(48) 3333-2222",
    "document": "123.456.789-00",
    "notes": "Prefere contato pela manhã.",
    "address_state": "SC",
    "address_city": "Florianópolis",
    "address_zipcode": "88015-600",
    "address_street": "Rua Bocaiúva",
    "address_number": "120",
    "address_complement": "Apto 302",
    "address_neighborhood": "Centro",
    "profession": "Engenheiro",
    "marital_status": "Casado",
    "marriage_regime": "Comunhão parcial de bens",
    "nationality": "Brasileira",
    "rg": "12.345.678-9",
    "rg_issuer": "SSP/SC",
    "origin": "Indicação",
    "spouse": {
        "birth_date": "1985-03-14",
        "name": "Maria Souza",
        "document": "123.456.789-00",
        "rg": "12.345.678-9",
        "email": "maria@exemplo.com",
        "profession": "Advogada",
        "nationality": "Brasileira"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/partner/v1/property-owner' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "document_type": "cpf",
    "birth_date": "1985-03-14",
    "partner_code": "PROP-4471",
    "name": "João da Silva Júnior",
    "whatsapp": "(48) 99999-1234",
    "email": "joao@exemplo.com",
    "phone": "(48) 3333-2222",
    "document": "123.456.789-00",
    "notes": "Prefere contato pela manhã.",
    "address_state": "SC",
    "address_city": "Florianópolis",
    "address_zipcode": "88015-600",
    "address_street": "Rua Bocaiúva",
    "address_number": "120",
    "address_complement": "Apto 302",
    "address_neighborhood": "Centro",
    "profession": "Engenheiro",
    "marital_status": "Casado",
    "marriage_regime": "Comunhão parcial de bens",
    "nationality": "Brasileira",
    "rg": "12.345.678-9",
    "rg_issuer": "SSP/SC",
    "origin": "Indicação",
    "spouse": {
        "birth_date": "1985-03-14",
        "name": "Maria Souza",
        "document": "123.456.789-00",
        "rg": "12.345.678-9",
        "email": "maria@exemplo.com",
        "profession": "Advogada",
        "nationality": "Brasileira"
    }
}'

Responses

🟢200
application/json
Proprietário atualizado.
Bodyapplication/json

Example
{
    "partner_code": "AP-1024",
    "property_owner_id": "66c1f3a2e4b0a1d2c3e4f5a6"
}
🟠400
🟠401
🟠403
🟠404
🟠429
🔴500
Modified at 2026-08-20 16:06:11
Previous
Cadastrar proprietário
Next
Cadastrar proprietários em lote
Built with