Passer au contenu principal
Liste paginée des collaborateurs de tout votre groupe d’agences, y compris ceux d’agences que votre clé ne couvre pas. La réponse ne dit pas à quelle agence chacun appartient. Permet de récupérer en une fois l’annuaire des collaborateurs : nom, prénom, téléphone, photo, fonction, statut.

Endpoint

URL : /external-integration/users Méthode : GET Authentification : Requiert un token LinkedAPI avec agencyGroup configuré. Clé requise : toutes les clés (lecture seule suffit). Voir Types de clé.

Headers

Query Parameters

Toute clé de query non listée → 400.
La liste comprend les collaborateurs désactivés qui restent rattachés à une agence du groupe, sans indicateur pour les distinguer. Avant de désigner un owner, vérifiez de votre côté que le collaborateur est toujours en poste.

Pagination

  • Taille de page fixe : 100 utilisateurs.
  • Pas de total retourné. Itérez jusqu’à hasMore: false.
  • page max : 100.
  • Le champ de taille de page de la réponse s’appelle ici limit — mais pageSize sur GET Activities et GET Ad Search. Même sens, deux noms : lisez celui de la route que vous appelez.
Bonne pratique : récupérez l’annuaire une seule fois via cette route (et mettez-le en cache de votre côté), plutôt que d’interroger /external-integration/user?id=... en boucle pour chaque identifiant rencontré. Les utilisateurs changent rarement ; un rafraîchissement périodique suffit.

Exemples de requête

Réponse de succès

Code : 200

Aucun résultat

Champs retournés

Les champs optionnels sont omis lorsqu’ils ne sont pas renseignés.

Réponses d’erreur

  • Paramètre de query inconnu : 400 Bad Request
  • page hors limites : 400 Bad Request
  • LinkedAPI agencyGroup manquant : 400 Bad Request
  • Header Authorization absent, ou IP non whitelistée sur une clé sécurisée : 403 Not authorized to access this resource
  • Token invalide : 401 Invalid bearer token

Notes

  1. Croisement avec les transactions/contacts : l’id retourné correspond à l’identifiant owner présent sur les ventes, acquisitions, locations et contacts. Utilisez cette route pour résoudre un owner en nom/prénom/photo.
  2. Scope : les utilisateurs sont limités à votre périmètre autorisé.
  3. Tri : par nom puis prénom.
  4. Endpoint en lecture seule.

Rate limits

Cette route est limitée à 20 req / minute par groupe d’agences (bucket dédié). Une seule requête (ou quelques pages) suffit pour récupérer tout l’annuaire — pas besoin d’un débit élevé.
  • Headers : RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (secondes avant reset).
  • Dépassement → 429 Too Many Requests avec header Retry-After :