Saltar al contenido
Todas las herramientas

m365_create_email_folder

Microsoft 365 · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Úsala cuando el usuario quiera una carpeta de correo nueva en su cuenta de Microsoft 365 / Outlook: se crea en el servidor Exchange, así que Outlook la muestra en todos los dispositivos. name es el nombre de la carpeta nueva; parent (opcional) la coloca dentro de una carpeta existente: un id, nombre o ruta de m365_list_email_folders, o inbox. Si ya existe una carpeta con ese nombre (en cualquier combinación de mayúsculas) bajo el mismo padre, no se crea nada y la respuesta es exists=true con su id. Muestra primero una vista previa: establece confirm=true para crearla. Responde created=true solo después de que Microsoft 365 devuelve la carpeta nueva en una segunda lectura. Necesita el permiso de Microsoft 365 Mail.ReadWrite: una cuenta conectada antes de que se pidiera responde consent_required hasta que se vuelva a conectar. Para una carpeta de una cuenta en la app Mail del Mac, usa create_email_folder.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para m365_create_email_folder. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows

Propósito

Úsala cuando el usuario quiera una carpeta de correo nueva en su cuenta de Microsoft 365 / Outlook: se crea en el servidor Exchange, así que Outlook la muestra en todos los dispositivos. name es el nombre de la carpeta nueva; parent (opcional) la coloca dentro de una carpeta existente: un id, nombre o ruta de m365_list_email_folders, o inbox. Si ya existe una carpeta con ese nombre (en cualquier combinación de mayúsculas) bajo el mismo padre, no se crea nada y la respuesta es exists=true con su id. Muestra primero una vista previa: establece confirm=true para crearla. Responde created=true solo después de que Microsoft 365 devuelve la carpeta nueva en una segunda lectura. Necesita el permiso de Microsoft 365 Mail.ReadWrite: una cuenta conectada antes de que se pidiera responde consent_required hasta que se vuelva a conectar. Para una carpeta en la app clásica de Outlook en este PC, usa outlook_create_folder.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para m365_create_email_folder. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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