m365_create_email_folder

Microsoft 365 · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Используйте, когда пользователю нужна новая почтовая папка в его аккаунте Microsoft 365 / Outlook: она создаётся на сервере Exchange, поэтому Outlook показывает её на всех устройствах. name — имя новой папки; parent (необязательно) помещает её внутрь существующей папки — id, имя или путь из m365_list_email_folders либо inbox. Если папка с таким именем (в любом регистре) уже существует в том же родителе, ничего не создаётся, а ответ — exists=true с её id. Сначала показывает предпросмотр — установите confirm=true, чтобы создать. Отвечает created=true только после того, как Microsoft 365 вернёт новую папку при втором чтении. Нужно разрешение Microsoft 365 Mail.ReadWrite: аккаунт, подключённый до того, как оно запрашивалось, отвечает consent_required, пока не будет подключён заново. Для папки аккаунта в приложении «Почта» на Mac используйте create_email_folder.

Обязательные входные данные

name

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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 (необязательно) помещает её внутрь существующей папки — id, имя или путь из m365_list_email_folders либо inbox. Если папка с таким именем (в любом регистре) уже существует в том же родителе, ничего не создаётся, а ответ — exists=true с её id. Сначала показывает предпросмотр — установите confirm=true, чтобы создать. Отвечает created=true только после того, как Microsoft 365 вернёт новую папку при втором чтении. Нужно разрешение Microsoft 365 Mail.ReadWrite: аккаунт, подключённый до того, как оно запрашивалось, отвечает consent_required, пока не будет подключён заново. Для папки в классическом приложении Outlook на этом ПК используйте outlook_create_folder.

Обязательные входные данные

name

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

Пример для документации

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