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
contentqui 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.Programmer un rappel
Envoyez unedeadline 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.
completionDate consigne une action déjà effectuée — un compte-rendu d’appel saisi après coup.
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é.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’
ownerde la fiche). ownerpermet 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.
owner fourni traverse deux contrôles :
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
activity retourné a la même forme que les éléments listés par GET /external-integration/activities.
Réponses d’erreur
documentmanquant :400 Bad Request
documentTypeinvalide :400 Bad Request
typenon autorisé :400 Bad Request
datarequis manquant (selon letype) :400 Bad Request
deadline/completionDatemal formée :400 Bad Request
ownerhors du périmètre de la clé :400 Bad Request
- Header
Authorizationabsent, 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 Requestsavec headerRetry-After: