BETA

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

LlamadaQué te daCuesta
GET .../usersTodos los usuarios con su correo y su rolnada
GET .../users?detail=trueLo mismo, y además nombre y teléfonos1 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"
}
CampoQué es
emailEl correo del usuario. Es lo que mandás en branch.agentEmail al publicar
roleEl rol normalizado: admin, superuser, assistant, agent. null si el portal usa uno que todavía no conocemos
portalRoleEl mismo rol tal como lo nombra el portal. Es el que vas a ver en su panel
firstName, lastName, phone, mobileSólo con detail=true. En el nivel gratis son null porque no los leímos, no porque el usuario no los tenga
detailSi el detalle se pudo leer de verdad
portalCallsCuá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ódigoQué pasó
409 portal_not_connectedEl cliente no tiene una conexión activa con ese portal
501 portal_sin_padron_de_usuariosEse portal no expone un padrón. No es un error tuyo — es que todavía no sabemos preguntárselo
502 portal_unreachableEl portal no respondió. Volvé a intentar

Hoy el padrón está disponible en Zonaprop (zonapropapi).