Los usuarios de tu cliente en el portal
GET /property-v1/customers/{portal}/users
Cuando publicás un aviso podés elegir qué asesor queda como responsable, mandando su correo en
branch.agentEmail. Pero ese correo tiene que ser el de
un usuario que exista en la cuenta del portal — y este endpoint es de donde lo sacás.
Si mandás un correo que no es de ningún usuario, el portal no te devuelve un error. Lo
reemplaza por el del administrador de la cuenta y la publicación sale 200. Por eso conviene leer
el padrón antes, en vez de descubrirlo mirando el aviso.
Dos niveles, y el que viene por defecto no cuesta nada
| Llamada | Qué te da | Cuesta |
|---|---|---|
GET .../users | Todos los usuarios con su correo y su rol | nada |
GET .../users?detail=true | Lo mismo, y además nombre y teléfonos | 1 llamada del cupo de tu cliente |
El nivel básico no es un recorte del otro: trae más gente. El detalle sólo existe para los usuarios con rol de asesor, así que el administrador aparece únicamente en el nivel gratis — y es justo el que el portal usa cuando no reconoce el correo que mandaste.
Cómo se pide
curl https://property-api.mapaprop.com/property-v1/customers/zonapropapi/users \
-H "Authorization: Bearer <TU_TOKEN>" \
-H "x-client-ref: cliente-42"
Respuesta 200:
{
"portal": "zonapropapi",
"portalAccountId": "11451",
"users": [
{ "email": "director@inmobiliaria.com", "role": "admin", "portalRole": "Administrador",
"firstName": null, "lastName": null, "phone": null, "mobile": null },
{ "email": "carina@inmobiliaria.com", "role": "agent", "portalRole": "Vendedor",
"firstName": null, "lastName": null, "phone": null, "mobile": null }
],
"detail": false,
"portalCalls": 0,
"readAt": "2026-11-16T21:40:12.004Z"
}
| Campo | Qué es |
|---|---|
email | El correo del usuario. Es lo que mandás en branch.agentEmail al publicar |
role | El rol normalizado: admin, superuser, assistant, agent. null si el portal usa uno que todavía no conocemos |
portalRole | El mismo rol tal como lo nombra el portal. Es el que vas a ver en su panel |
firstName, lastName, phone, mobile | Sólo con detail=true. En el nivel gratis son null porque no los leímos, no porque el usuario no los tenga |
detail | Si el detalle se pudo leer de verdad |
portalCalls | Cuántas llamadas del cupo de tu cliente costó esta consulta |
Con el detalle
curl "https://property-api.mapaprop.com/property-v1/customers/zonapropapi/users?detail=true" \
-H "Authorization: Bearer <TU_TOKEN>" \
-H "x-client-ref: cliente-42"
{
"users": [
{ "email": "carina@inmobiliaria.com", "role": "agent", "portalRole": "Vendedor",
"firstName": "Carina", "lastName": "Milesse", "phone": "3425050115", "mobile": null }
],
"detail": true,
"portalCalls": 1
}
Sirve para armar el contacto completo del aviso: si elegís un asesor, conviene que mandes también su
nombre y su teléfono en branch, porque el portal no los deduce del correo.
Si el detalle no se puede leer, la respuesta no falla: te devuelve el padrón igual, con
detail: false. Perder el dato extra es mejor que perder la lista.
Los usuarios se dan de alta en el portal, no acá
Esta API no crea, no edita ni da de baja usuarios. El alta de un colaborador, sus permisos y su número de WhatsApp se administran desde el panel del portal, por el propio cliente.
Si tu cliente agrega un asesor en su CRM pero no lo carga en el portal, su correo no va a funcionar
como agentEmail: el portal no lo reconoce y asigna el aviso al administrador.
Cuándo da error
| Código | Qué pasó |
|---|---|
409 portal_not_connected | El cliente no tiene una conexión activa con ese portal |
501 portal_sin_padron_de_usuarios | Ese portal no expone un padrón. No es un error tuyo — es que todavía no sabemos preguntárselo |
502 portal_unreachable | El portal no respondió. Volvé a intentar |
Hoy el padrón está disponible en Zonaprop (zonapropapi).