Ir para o conteúdo
Todas as ferramentas

m365_create_email_folder

Microsoft 365 · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Use quando o usuário quiser uma nova pasta de e-mail na sua conta do Microsoft 365 / Outlook: ela é criada no servidor Exchange, então o Outlook a mostra em todos os dispositivos. name é o nome da nova pasta; parent (opcional) a coloca dentro de uma pasta existente — um id, nome ou caminho de m365_list_email_folders, ou inbox. Se já existir uma pasta com esse nome (em qualquer caixa) sob o mesmo parent, nada é criado e a resposta é exists=true com o id dela. Mostra uma prévia primeiro — defina confirm=true para criar. Responde created=true somente depois que o Microsoft 365 retorna a nova pasta em uma segunda leitura. Precisa da permissão Mail.ReadWrite do Microsoft 365: uma conta conectada antes de ela ser pedida responde consent_required até ser conectada de novo. Para uma pasta de uma conta do app Mail do Mac, use create_email_folder.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para m365_create_email_folder. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Use quando o usuário quiser uma nova pasta de e-mail na sua conta do Microsoft 365 / Outlook: ela é criada no servidor Exchange, então o Outlook a mostra em todos os dispositivos. name é o nome da nova pasta; parent (opcional) a coloca dentro de uma pasta existente — um id, nome ou caminho de m365_list_email_folders, ou inbox. Se já existir uma pasta com esse nome (em qualquer caixa) sob o mesmo parent, nada é criado e a resposta é exists=true com o id dela. Mostra uma prévia primeiro — defina confirm=true para criar. Responde created=true somente depois que o Microsoft 365 retorna a nova pasta em uma segunda leitura. Precisa da permissão Mail.ReadWrite do Microsoft 365: uma conta conectada antes de ela ser pedida responde consent_required até ser conectada de novo. Para uma pasta no app Outlook clássico neste PC, use outlook_create_folder.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para m365_create_email_folder. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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