curl --request POST \
--url https://api.avest.fr/v1/external-integration/activity \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document": "6a04a0aed4948142783f8cdf",
"documentType": "acquisition",
"type": "note",
"data": {
"content": "Client recontacté, visite à planifier la semaine prochaine."
}
}
'{
"success": true,
"activity": {
"id": "6a04a0aed4948142783f8ce0",
"type": "note",
"startAt": null,
"endAt": null,
"deadline": null,
"completionDate": "2026-06-29T10:00:00.000Z",
"pinned": false,
"owner": "6939530d9200187f19a2707d",
"linkedDocument": "6a04a0aed4948142783f8cdf",
"linkedModel": "acquisition",
"data": {
"content": "Client recontacté, visite à planifier la semaine prochaine."
},
"file": null,
"driveLinks": [],
"createdAt": "2026-06-29T10:00:00.000Z",
"updatedAt": "2026-06-29T10:00:00.000Z"
}
}Créer une activité sur un document
Crée une activité (note, tâche, appel, message, email, rendez-vous) sur un document existant : acquisition (fiche acquéreur), vente, location ou contact.
document, documentType, type et data sont obligatoires. documentType doit valoir acquisition, sale, rental ou contact. type doit appartenir à la liste des types autorisés (voir ActivityType) — les types système ne sont pas créables via l’API. Le contenu attendu dans data dépend du type : note et task requièrent data.content ; call, message, email et meeting requièrent data.title ; appointment n’a pas de champ requis.
L’activité est rattachée au document et, par défaut, attribuée à l’utilisateur Avest responsable du dossier — owner permet de désigner le collaborateur qui a réellement réalisé l’action. Le document doit appartenir au périmètre autorisé du token (agencyGroup + agences de la clé), sinon 401.
Programmer un rappel : envoyez une deadline future sans completionDate. L’activité reste « à faire » et apparaît 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.
curl --request POST \
--url https://api.avest.fr/v1/external-integration/activity \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"document": "6a04a0aed4948142783f8cdf",
"documentType": "acquisition",
"type": "note",
"data": {
"content": "Client recontacté, visite à planifier la semaine prochaine."
}
}
'{
"success": true,
"activity": {
"id": "6a04a0aed4948142783f8ce0",
"type": "note",
"startAt": null,
"endAt": null,
"deadline": null,
"completionDate": "2026-06-29T10:00:00.000Z",
"pinned": false,
"owner": "6939530d9200187f19a2707d",
"linkedDocument": "6a04a0aed4948142783f8cdf",
"linkedModel": "acquisition",
"data": {
"content": "Client recontacté, visite à planifier la semaine prochaine."
},
"file": null,
"driveLinks": [],
"createdAt": "2026-06-29T10:00:00.000Z",
"updatedAt": "2026-06-29T10:00:00.000Z"
}
}Autorisations
Token LinkedAPI avec scope externalIntegration. La clé doit avoir un agencyGroup configuré (sinon 400 LinkedAPI agencyGroup is required). Fourni via l'en-tête Authorization: Bearer {linkedAPI_token}. Si la clé a secure === true, l'IP appelante doit être whitelistée (en-tête X-Real-IP), sinon 403 Not authorized to access this resource.
La clé porte aussi un niveau d'accès : en lecture seule, elle n'autorise que les GET ; un POST ou un PATCH renvoie alors 403 Not authorized to access this resource, soit la même réponse qu'une requête sans en-tête Authorization. Voir le guide Authentification.
Corps
Données de l'activité. Champs attendus selon le type : content (texte) pour note / task ; title (avec content optionnel) pour call / message / email / meeting.
content accepte du texte brut ou du HTML. En texte brut, une ligne vide (\n\n) sépare deux paragraphes et un \n simple reste un retour à la ligne ; le texte est converti en HTML à l'enregistrement. Un content contenant au moins une balise est enregistré tel quel. Balises reconnues : <p>, <br>, <strong>, <em>, <u>, <s>, <code>, <pre>, <ul> / <ol> / <li>, <h1>-<h3>, <blockquote>, <a href> en http/https.
Date de réalisation (ISO 8601). À renseigner pour consigner une action déjà effectuée (compte-rendu d'appel a posteriori). Si elle est fournie, la deadline que vous envoyez est écartée — une activité terminée n'a plus d'échéance à venir.
La réponse renvoie malgré tout une deadline, qui vaut alors la completionDate : c'est la date que la fiche affiche, pour qu'un rendez-vous consigné après coup apparaisse à sa date réelle et non à celle de l'appel API.
Collaborateur à qui attribuer l'activité — celui qui a réellement passé l'appel. Par défaut, l'activité est attribuée au propriétaire du document lié.
Deux contrôles s'appliquent, et le second est le plus strict : le collaborateur doit appartenir aux agences de votre clé (sinon 400 owner is not in the authorized scope of this LinkedAPI) et, sur une vente, à l'agence du document visé (sinon 400 Activity's sale owner not found).
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 sauf certitude.
^[a-fA-F0-9]{24}$"618a35a36d932054e195ca0a"