Atribuir cliente a corretor

POST

/partner/v1/lead/assign-agent

Grava quem responde pelo cliente no CRM — o "Atendido por" das telas da Homfy. O cliente vem pelo SEU código; o corretor, pelo id dele na Homfy, que sai de POST /partner/v1/realstate-agent/search.

Atribuir um cliente que já tem outro corretor SUBSTITUI o responsável, sem erro e sem aviso ao anterior. Não há como DESatribuir por aqui — o campo não aceita null. A alteração aparece na linha do tempo do cliente.

O que esta rota faz é só isto: grava quem responde pelo cliente. Ela NÃO inicia o fluxo de atendimento da imobiliária e não notifica ninguém — de propósito, porque uma carga de integração viraria uma enxurrada de avisos. Quem conduz o atendimento faz isso pelo painel.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Example

{
    "realstate_agent_id": 42,
    "partner_code": "CLI-8842"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/partner/v1/lead/assign-agent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "realstate_agent_id": 42,
    "partner_code": "CLI-8842"
}'

Responses

🟢201

application/json

Corretor responsável gravado.

Bodyapplication/json

Example

{
    "partner_code": "AP-1024",
    "lead_id": 900,
    "realstate_agent_id": 42
}

🟠400

🟠401

🟠403

🟠404

🟠429

🔴500

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

Buscar clientes

Consultar corretores