m365_create_email_folder
Microsoft 365 · macOS · Windows
Effetto: scrittura. Stato: disponibilità condizionata.
«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.
macOS
Scopo
Da usare quando l'utente vuole una nuova cartella di posta nel suo account Microsoft 365 / Outlook: viene creata sul server Exchange, quindi Outlook la mostra su ogni dispositivo. name è il nome della nuova cartella; parent (facoltativo) la colloca dentro una cartella esistente: un id, un nome o un percorso da m365_list_email_folders, oppure inbox. Se sotto lo stesso parent esiste già una cartella con quel nome (in qualsiasi caso), non viene creato nulla e la risposta è exists=true con il suo id. Mostra prima un'anteprima: imposta confirm=true per creare. Risponde created=true solo dopo che Microsoft 365 restituisce la nuova cartella in una seconda lettura. Richiede il permesso Mail.ReadWrite di Microsoft 365: un account collegato prima che venisse richiesto risponde consent_required finché non viene collegato di nuovo. Per una cartella di un account nell'app Mail del Mac usa create_email_folder.
Input obbligatori
name
I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.
Autorizzazioni e conferma
Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — 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"
}Esempio documentale
Esempio di documentazione per m365_create_email_folder. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"confirm": false,
"name": "Launch 2026",
"parent": "inbox"
}Windows
Scopo
Da usare quando l'utente vuole una nuova cartella di posta nel suo account Microsoft 365 / Outlook: viene creata sul server Exchange, quindi Outlook la mostra su ogni dispositivo. name è il nome della nuova cartella; parent (facoltativo) la colloca dentro una cartella esistente: un id, un nome o un percorso da m365_list_email_folders, oppure inbox. Se sotto lo stesso parent esiste già una cartella con quel nome (in qualsiasi caso), non viene creato nulla e la risposta è exists=true con il suo id. Mostra prima un'anteprima: imposta confirm=true per creare. Risponde created=true solo dopo che Microsoft 365 restituisce la nuova cartella in una seconda lettura. Richiede il permesso Mail.ReadWrite di Microsoft 365: un account collegato prima che venisse richiesto risponde consent_required finché non viene collegato di nuovo. Per una cartella nell'app Outlook classica su questo PC usa outlook_create_folder.
Input obbligatori
name
I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.
Autorizzazioni e conferma
Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — 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"
}Esempio documentale
Esempio di documentazione per m365_create_email_folder. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"confirm": false,
"name": "Launch 2026",
"parent": "inbox"
}