Mankomail

Créer un événement Outlook ​

Pose un rendez-vous dans votre agenda Outlook. Les invitations ne partent que si vous le demandez.

Ce nœud crée un événement dans l’agenda Outlook du membre qui exécute le workflow : un rendez-vous confirmé par mail, une échéance, un rappel. Les invitations ne partent que si vous le demandez.

Il exige l’accès agenda d’un compte Microsoft, affiché comme la capacité Agenda dans Connexions. Voir Microsoft.

Pour proposer d’abord des créneaux libres, utilisez Trouver un créneau Outlook : ses créneaux sont exactement au format qu’attend ce nœud. Pour Google Agenda, utilisez Agenda — créer un événement.

En bref ​

  • Type : outlook_calendar.create_event · version 1
  • Catégorie : Actions
  • Nature : Étape — s’exécute pendant une exécution
  • Effet : Écrit à l’extérieur (external_write) — écrit hors de Mankomail ; décrit au lieu d’être fait pendant un essai
  • Exige un mail porteur : Non
  • Connexion : Microsoft (capacité calendar)
  • Entrées : main
  • Sorties : main

Connexion ​

Ce nœud exige une connexion Microsoft avec la capacité calendar accordée.

Paramètres ​

credential ​

Compte Microsoft — Le compte dont on utilise l’agenda. Connectez-le depuis Connexions ; le jeton est résolu par le serveur.

  • Type : Connexion (credential)
  • Requis : Non
  • Défaut : "" (vide)

calendar ​

Agenda — Laissé vide : votre agenda par défaut.

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Défaut : {"mode":"id","value":""}
  • Façons de choisir : dans une liste, saisir un identifiant (outlook.calendar)
  • Listé avec la connexion de : credential

title ​

Titre

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 255 caractères au plus
  • Exemple : Point projet — {{ email.from.name }}
  • Expressions : {{ }} accepté

start ​

Début — Date et heure au format ISO, sans fuseau : 2026-04-02T14:00:00. Accepte des expressions {{ }} — {{ data.find_free_1.slots.0.start }} branche directement la recherche de créneaux.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Exemple : 2026-04-02T14:00:00
  • Expressions : {{ }} accepté

end ​

Fin — Même format que le début. Pour une journée entière, mettez les deux dates à minuit.

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Exemple : 2026-04-02T15:00:00
  • Expressions : {{ }} accepté

allDay ​

Journée entière — Graph exige alors des bornes à minuit — le service refuse l’événement plutôt que d’arrondir à votre insu.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : false

timeZone ​

Fuseau horaire — Nom IANA (Europe/Paris, America/Montreal). C’est lui qui donne son sens aux heures saisies.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : Europe/Paris
  • 80 caractères au plus
  • Expressions : {{ }} accepté

body ​

Description — Le corps de l’événement. Accepte des expressions {{ }}.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 20000 caractères au plus
  • Expressions : {{ }} accepté

location ​

Lieu

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 255 caractères au plus
  • Exemple : Visio, salle Nord…
  • Expressions : {{ }} accepté

attendees ​

Participants — Adresses séparées par des virgules. {{ email.from.email }} invite l’expéditeur du mail.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 2000 caractères au plus
  • Exemple : {{ email.from.email }}
  • Expressions : {{ }} accepté

sendInvitations ​

Envoyer les invitations — Désactivé, l’événement est posé dans votre agenda sans qu’aucun mail ne parte. Activé, Outlook prévient les participants.

  • Type : Oui / non (boolean)
  • Requis : Non
  • Défaut : false
  • Affiché quand : attendees est renseigné

Sorties ​

  • main

Données produites ​

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

  • {{ data.<step>.event }} — object { id, webLink, start, end, timeZone }. L’événement créé, ou retrouvé lors d’une nouvelle tentative. id est l’identifiant de l’événement Outlook, webLink le lien qui l’ouvre dans Outlook sur le web, start et end les bornes telles qu’Outlook les a enregistrées, timeZone leur fuseau.
  • {{ data.<step>.event.webLink }} — string. Le lien Outlook de l’événement. Vide en essai.
  • {{ data.<step>.reused }} — boolean. true quand une nouvelle tentative a retrouvé l’événement créé par une tentative précédente de la même étape : rien n’a été recréé.
  • {{ data.<step>.invited }} — number. Le nombre de participants qu’Outlook a été chargé d’inviter. 0 quand « Envoyer les invitations » est désactivé ou qu’il n’y a aucun participant.
  • {{ data.<step>.summary }} — string. Une phrase lisible qui donne le titre et le début de l’événement, et si des invitations sont parties.

Exemple ​

Après Trouver un créneau Outlook (nommé Créneaux) et la réponse du client, le nœud, nommé Poser l’appel, réserve le premier créneau :

calendar: (mode identifiant) (vide : agenda par défaut)
title: Point projet — {{ email.from.name }}
start: {{ data.creneaux.first.start }}
end: {{ data.creneaux.first.end }}
allDay: false
timeZone: Europe/Paris
location: Visio
attendees: {{ email.from.email }}
sendInvitations: true

Les données de l’étape sont :

json
{
  "event": {
    "id": "AAMkAGI2…",
    "webLink": "https://outlook.office365.com/owa/?itemid=AAMkAGI2…",
    "start": "2026-04-14T10:00:00.0000000",
    "end": "2026-04-14T10:30:00.0000000",
    "timeZone": "Europe/Paris"
  },
  "reused": false,
  "invited": 1
}

Conseils ​

  • Invitations désactivées par défaut. « Envoyer les invitations » apparaît dès que « Participants » est rempli et reste désactivé par défaut. Outlook écrit aux participants dès qu’ils figurent sur un événement : quand l’option est désactivée, le nœud ne les ajoute donc pas comme participants. L’événement est créé dans votre seul agenda, et une ligne qui liste leurs adresses est ajoutée à sa description. Activez l’option pour qu’Outlook les invite.
  • Pas de doublon à la nouvelle tentative. Le nœud pose une marque invisible sur l’événement et la cherche avant de créer : une nouvelle tentative de l’étape rend l’événement existant avec reused: true. Certains tenants refusent cette recherche ; chez eux, une nouvelle tentative peut créer un second événement.
  • Dates et fuseau. « Début » et « Fin » sont des dates-heures ISO sans fuseau (2026-04-14T14:00:00), lues dans le « Fuseau horaire » (nom IANA, Europe/Paris par défaut). Un fuseau inconnu échoue avec microsoft.rejected.
  • Journée entière. Avec « Journée entière » activé, « Début » et « Fin » doivent tomber tous deux à minuit dans le fuseau (pour un jour : 2026-04-14T00:00:00 à 2026-04-15T00:00:00). Toute autre heure échoue avec microsoft.rejected plutôt que d’être arrondie.
  • Participants. Adresses séparées par des virgules. Une entrée qui n’est pas une adresse mail (par exemple une expression non résolue) échoue avec node_invalid_param. Un « Titre », un « Début » ou une « Fin » résolus à vide échouent aussi avec node_invalid_param.
  • Agenda. Laissé vide, l’agenda par défaut du membre. Choisissez-en un autre dans la liste (les agendas en lecture seule n’y figurent pas) ou saisissez son identifiant. Ce champ n’a pas de mode URL.
  • Essais. En essai, rien n’est créé et personne n’est invité : l’événement rendu a un identifiant qui commence par simulated:, un webLink vide, et le début et la fin tels que saisis.
  • Erreurs. credential.capability_missing : l’agenda Outlook n’est pas connecté pour le membre qui exécute le workflow. microsoft.access_denied ou microsoft.auth_failed : reconnectez le compte. microsoft.not_found : l’agenda n’existe plus. microsoft.unavailable est retenté automatiquement. Voir Gestion des erreurs.