Passer au contenu principal
Crée une activité sur un document existant — typiquement une note sur une fiche acquéreur, mais aussi une tâche, un appel, un message, un email ou un rendez-vous, sur une acquisition, une vente, une location ou un contact.

Endpoint

URL : /external-integration/activity Méthode : POST Authentification : Requiert un token LinkedAPI avec scope externalIntegration et une clé rattachée à un groupe d’agences. Clé requise : lecture-écriture. Une clé en lecture seule reçoit 403. Voir Types de clé.

Headers

Body Parameters

Types d’activité (type)

Seuls les types « manuels » sont créables via l’API. Les types système (changement d’étape, offre, séquence, etc.) ne le sont pas.
content est optionnel (en plus de title) pour call, message, email et meeting. Le champ data est ouvert : tout champ supplémentaire pertinent pour le type est accepté.

Mise en forme de content

content accepte du texte brut ou du HTML.
  • Texte brut : séparez les paragraphes par une ligne vide (\n\n) ; un saut de ligne simple (\n) reste un retour à la ligne dans le paragraphe. Avest convertit ce texte en HTML à l’enregistrement (&, < et > sont échappés) : GET Activities vous renvoie donc la version HTML.
  • HTML : pour la mise en forme (gras, listes…). Un content qui contient au moins une balise est enregistré tel quel.
Balises reconnues : <p>, <br>, <strong>, <em>, <u>, <s>, <code>, <pre>, <ul> / <ol> / <li>, <h1>–<h3>, <blockquote>, et <a href> en http / https. Le reste est nettoyé à l’affichage.
Une note saisie depuis l’interface Avest est stockée dans un format interne (un document d’éditeur sérialisé en JSON). N’essayez pas de le reproduire : ce format n’est pas un contrat d’API et peut changer sans préavis. Envoyez du texte brut ou du HTML.

Programmer un rappel

Envoyez une deadline future et pas de completionDate : l’activité reste « à faire » et remonte dans les relances du négociateur, exactement comme un rappel créé depuis l’interface Avest.
À l’inverse, une completionDate consigne une action déjà effectuée — un compte-rendu d’appel saisi après coup.
Sur une vente jusqu’à l’étape DLV, créer un appel, une tâche, un message, un email ou un rendez-vous (meeting) clôt les autres activités à faire de la fiche, rendez-vous d’estimation compris. Les notes, les visites et les offres ne sont pas concernées.
Les deux champs s’excluent : si vous fournissez une completionDate, la deadline que vous envoyez est écartée. Une activité terminée n’a plus d’échéance à venir.
La réponse renvoie quand même une deadline : elle vaut alors la completionDate. C’est cette date que la fiche affiche (« était planifié le … »), pour qu’un rendez-vous consigné après coup s’affiche à sa date réelle et non à celle de l’appel API.
deadline et completionDate sont des chaînes de date ISO 8601 (2026-08-12T09:00:00.000Z). Un timestamp numérique ou null est refusé.
Une fois le rappel honoré, soldez-le avec PATCH Activity : sans cela il reste « à faire » et continue de remonter dans les relances du négociateur.

Périmètre et attribution

  • Le document doit appartenir au périmètre autorisé du token (agencyGroup + agences de la clé). Sinon → 403 Not authorized to access this resource.
  • Par défaut, l’activité est attribuée à l’utilisateur Avest responsable du dossier (l’owner de la fiche).
  • owner permet de désigner le collaborateur qui a réellement réalisé l’action — celui qui a passé l’appel. Récupérez son ObjectId via GET Users.
L’owner fourni traverse deux contrôles :
Le second contrôle est plus strict que le premier. Une clé qui couvre plusieurs agences peut très bien renvoyer, via GET Users, un collaborateur valide pour la clé mais pas pour l’agence de la vente — la requête est alors refusée et rien n’est écrit.
GET /users ne renvoie pas les agences d’un collaborateur : vous ne pouvez pas savoir à l’avance lequel est valide pour une vente donnée. En pratique, omettez owner (l’activité revient au responsable du dossier, toujours valide) sauf si vous savez de source sûre que le collaborateur est rattaché à l’agence de la fiche.

Exemples de requête

Note sur une fiche acquéreur

Appel sur un contact

Réponse de succès

Code : 201
L’objet activity retourné a la même forme que les éléments listés par GET /external-integration/activities.

Réponses d’erreur

  • document manquant : 400 Bad Request
  • documentType invalide : 400 Bad Request
  • type non autorisé : 400 Bad Request
  • data requis manquant (selon le type) : 400 Bad Request
  • deadline / completionDate mal formée : 400 Bad Request
  • owner hors du périmètre de la clé : 400 Bad Request
  • Header Authorization absent, clé en lecture seule, document lié hors périmètre, ou IP non whitelistée sur une clé sécurisée : 403 Not authorized to access this resource
  • Token invalide : 401 Invalid bearer token

Rate limits

Cette route est limitée à 100 req / minute par groupe d’agences (un compteur par groupe d’agences × route : les autres routes d’écriture ont chacune le leur).
  • Headers : RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (secondes avant reset).
  • Dépassement → 429 Too Many Requests avec header Retry-After :