m365_create_email_folder
Microsoft 365 · macOS · Windows
Wirkung: Schreiben. Status: bedingt verfügbar.
„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.
macOS
Zweck
Verwenden Sie es, wenn der Benutzer einen neuen Mail-Ordner in seinem Microsoft-365-/Outlook-Konto möchte: Er wird auf dem Exchange-Server erstellt, sodass Outlook ihn auf jedem Gerät zeigt. name ist der Name des neuen Ordners; parent (optional) legt ihn in einen bestehenden Ordner – eine id, ein Name oder ein Pfad aus m365_list_email_folders, oder inbox. Existiert unter demselben übergeordneten Ordner bereits ein Ordner mit diesem Namen (in beliebiger Schreibweise), wird nichts erstellt und die Antwort lautet exists=true mit seiner id. Zeigt zuerst eine Vorschau – setzen Sie confirm=true, um zu erstellen. Antwortet created=true erst, nachdem Microsoft 365 den neuen Ordner bei einem zweiten Lesen zurückgibt. Erfordert die Microsoft-365-Berechtigung Mail.ReadWrite: Ein Konto, das verbunden wurde, bevor sie angefragt wurde, antwortet consent_required, bis es erneut verbunden wird. Für einen Ordner eines Kontos in der Mail-App des Macs verwenden Sie create_email_folder.
Erforderliche Eingaben
name
Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.
Berechtigungen und Bestätigung
Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.
- Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.
Kanonisches technisches Schema auf Englisch — macOS
{
"properties": {
"account": {
"description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
"type": "string"
},
"confirm": {
"description": "Set to true to create the folder (default: shows a preview only).",
"type": "boolean"
},
"name": {
"description": "The new folder's name: one line, without /, at most 255 characters.",
"type": "string"
},
"parent": {
"description": "Folder to create it in: an id, name or path from m365_list_email_folders, or inbox. Leave it out for a top-level folder.",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für m365_create_email_folder. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.
{
"confirm": false,
"name": "Launch 2026",
"parent": "inbox"
}Windows
Zweck
Verwenden Sie es, wenn der Benutzer einen neuen Mail-Ordner in seinem Microsoft-365-/Outlook-Konto möchte: Er wird auf dem Exchange-Server erstellt, sodass Outlook ihn auf jedem Gerät zeigt. name ist der Name des neuen Ordners; parent (optional) legt ihn in einen bestehenden Ordner – eine id, ein Name oder ein Pfad aus m365_list_email_folders, oder inbox. Existiert unter demselben übergeordneten Ordner bereits ein Ordner mit diesem Namen (in beliebiger Schreibweise), wird nichts erstellt und die Antwort lautet exists=true mit seiner id. Zeigt zuerst eine Vorschau – setzen Sie confirm=true, um zu erstellen. Antwortet created=true erst, nachdem Microsoft 365 den neuen Ordner bei einem zweiten Lesen zurückgibt. Erfordert die Microsoft-365-Berechtigung Mail.ReadWrite: Ein Konto, das verbunden wurde, bevor sie angefragt wurde, antwortet consent_required, bis es erneut verbunden wird. Für einen Ordner in der klassischen Outlook-App auf diesem PC verwenden Sie outlook_create_folder.
Erforderliche Eingaben
name
Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.
Berechtigungen und Bestätigung
Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.
- Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.
Kanonisches technisches Schema auf Englisch — Windows
{
"properties": {
"account": {
"description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
"type": "string"
},
"confirm": {
"description": "Set to true to create the folder (default: shows a preview only).",
"type": "boolean"
},
"name": {
"description": "The new folder's name: one line, without /, at most 255 characters.",
"type": "string"
},
"parent": {
"description": "Folder to create it in: an id, name or path from m365_list_email_folders, or inbox. Leave it out for a top-level folder.",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für m365_create_email_folder. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.
{
"confirm": false,
"name": "Launch 2026",
"parent": "inbox"
}