Vincular proprietário a imóvel

POST

/partner/v1/property-owner/link-property

Liga um proprietário a um imóvel usando os DOIS códigos do seu sistema — você nunca precisa dos ids internos da Homfy.

Um imóvel tem no máximo um proprietário: vincular um imóvel que já tem outro SUBSTITUI o vínculo, sem erro. Um proprietário pode ter quantos imóveis for.

Os dois precisam já estar cadastrados: cadastre o imóvel em /partner/v1/property e o proprietário aqui antes de vincular.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "partner_code": "PROP-4471",
    "property_partner_code": "AP-1024"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/partner/v1/property-owner/link-property' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "partner_code": "PROP-4471",
    "property_partner_code": "AP-1024"
}'

Responses

🟢201

application/json

Vínculo gravado.

Bodyapplication/json

Example

{
    "partner_code": "AP-1024",
    "property_owner_id": "66c1f3a2e4b0a1d2c3e4f5a6",
    "property_id": 1547,
    "property_partner_code": "string"
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500

Modified at 2026-08-20 16:06:11

Buscar proprietários

Cadastrar cliente