本文へスキップ
すべてのツール

m365_create_email_folder

Microsoft 365 · macOS · Windows

効果: 書き込み. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

ユーザーが Microsoft 365 / Outlook アカウントに新しいメールフォルダを作成したいときに使います。Exchange サーバー上に作成されるため、Outlook ではすべてのデバイスに表示されます。name は新しいフォルダの名前で、parent(任意)は既存のフォルダの中に作成します。m365_list_email_folders で得た id、名前、パス、または inbox を指定します。同じ親の下に同じ名前(大文字小文字を問わない)のフォルダがすでにある場合は、何も作成されず、応答は exists=true とその id になります。最初にプレビューを表示し、confirm=true を設定すると作成します。Microsoft 365 が 2 回目の読み取りで新しいフォルダを返した場合にのみ、created=true を返します。Microsoft 365 の権限 Mail.ReadWrite が必要です。この権限が求められる前に接続されたアカウントは、再接続するまで consent_required を返します。Mac の Mail アプリのアカウントのフォルダには、create_email_folder を使ってください。

必須入力

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

英語の正規技術スキーマ — 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"
}

ドキュメント例

m365_create_email_folder のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "confirm": false,
  "name": "Launch 2026",
  "parent": "inbox"
}

Windows

目的

ユーザーが Microsoft 365 / Outlook アカウントに新しいメールフォルダを作成したいときに使います。Exchange サーバー上に作成されるため、Outlook ではすべてのデバイスに表示されます。name は新しいフォルダの名前で、parent(任意)は既存のフォルダの中に作成します。m365_list_email_folders で得た id、名前、パス、または inbox を指定します。同じ親の下に同じ名前(大文字小文字を問わない)のフォルダがすでにある場合は、何も作成されず、応答は exists=true とその id になります。最初にプレビューを表示し、confirm=true を設定すると作成します。Microsoft 365 が 2 回目の読み取りで新しいフォルダを返した場合にのみ、created=true を返します。Microsoft 365 の権限 Mail.ReadWrite が必要です。この権限が求められる前に接続されたアカウントは、再接続するまで consent_required を返します。この PC のクラシック Outlook アプリのフォルダには、outlook_create_folder を使ってください。

必須入力

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがあります。プレビューを確認し、プラットフォーム契約に従って実操作を承認してください。

英語の正規技術スキーマ — 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"
}

ドキュメント例

m365_create_email_folder のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{
  "confirm": false,
  "name": "Launch 2026",
  "parent": "inbox"
}