Skip to content

Kalender-Termin erstellen (Outlook)

Dieser Service Task erstellt einen Termin im Outlook-Kalender eines Benutzers über die Microsoft Graph API. Er unterstützt Teilnehmer, Ort, Online-Meetings (automatischer Teams-Link), Erinnerungen und Ganztags-Termine.

Nutzen: Meetings, Fristen und Follow-ups können automatisch als Teil eines Geschäftsprozesses geplant werden — ohne manuelle Kalendereinträge.

Voraussetzungen

Eine Microsoft Entra ID (Azure AD) App-Registrierung ist erforderlich mit:

  • Anwendungsberechtigung: Calendars.ReadWrite
  • Admin-Einwilligung für den Tenant erteilt

Die Anmeldedaten können als Pantarey Secrets gespeichert und über {{secret:NAME}} referenziert werden.

Eingabeparameter

Parameter Typ Pflicht Beschreibung
credentials Objekt Ja { tenantId, oAuthClientID, clientSecret } — Microsoft Entra ID Anmeldedaten.
userId String Ja User Principal Name oder Objekt-ID (z. B. max@contoso.com).
subject String Ja Betreff des Termins.
start String Ja Startdatum/-zeit (ISO-Format ohne Zeitzone, z. B. 2026-02-20T09:00:00).
end String Ja Enddatum/-zeit (ISO-Format).
body String Nein Beschreibung / Notizen des Termins.
bodyType String Nein text oder html. Standard: text.
attendees Array Nein Teilnehmer — entweder E-Mail-Strings oder Objekte { email, name?, type? }. Type: required, optional, resource.
location String / Objekt Nein Raum oder Ortsname.
isOnlineMeeting Boolean Nein Wenn true, wird automatisch ein Teams-Meeting-Link generiert.
reminderMinutes Zahl Nein Erinnerung vor dem Termin (in Minuten).
isAllDay Boolean Nein Wenn true, wird ein Ganztags-Termin erstellt.
timeZone String Nein Zeitzone für Start/Ende. Standard: Europe/Berlin.

Beispiel-Eingabe

{
  "credentials": {
    "tenantId": "{{secret:MS_TENANT_ID}}",
    "oAuthClientID": "{{secret:MS_CLIENT_ID}}",
    "clientSecret": "{{secret:MS_CLIENT_SECRET}}"
  },
  "userId": "max@contoso.com",
  "subject": "Onboarding-Gespräch",
  "start": "2026-02-20T09:00:00",
  "end": "2026-02-20T10:00:00",
  "body": "Willkommen im Team! Bitte bringe deinen Laptop mit.",
  "attendees": ["anna@contoso.com", "tom@contoso.com"],
  "location": "Raum Berlin",
  "isOnlineMeeting": true,
  "timeZone": "Europe/Berlin"
}

Ausgabe

Feld Typ Beschreibung
eventId String Die ID des erstellten Termins.
subject String Der Betreff des Termins.
start Objekt { dateTime, timeZone }.
end Objekt { dateTime, timeZone }.
webLink String / null URL zum Öffnen des Termins in Outlook Web.
onlineMeetingUrl String / null Teams-Meeting-Beitritts-URL (wenn isOnlineMeeting true war).
createdDateTime String ISO-Zeitstempel der Erstellung.

Beispiel-Ausgabe

{
  "eventId": "AAMkAGI2...",
  "subject": "Onboarding-Gespräch",
  "start": { "dateTime": "2026-02-20T09:00:00", "timeZone": "Europe/Berlin" },
  "end": { "dateTime": "2026-02-20T10:00:00", "timeZone": "Europe/Berlin" },
  "webLink": "https://outlook.office365.com/owa/?itemid=...",
  "onlineMeetingUrl": "https://teams.microsoft.com/l/meetup-join/...",
  "createdDateTime": "2026-02-14T10:30:00Z"
}

Anwendungsfälle

  • Onboarding: Automatisch ein Willkommensgespräch planen, wenn ein Mitarbeiter-Prozess startet.
  • Genehmigungs-Follow-ups: Review-Meeting erstellen, nachdem eine Genehmigung erteilt wurde.
  • Fristen: Kalender-Erinnerung für Vertragsverlängerung oder Zahlungsfälligkeit.
  • Bewerbungsgespräche: Interviews als Teil eines HR-Prozesses terminieren.
  • Teams-Meetings: Teams-Meeting-Link automatisch generieren durch isOnlineMeeting: true.