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가 두 번째 읽기에서 새 폴더를 반환한 후에만 created=true로 응답합니다. Microsoft 365 권한 Mail.ReadWrite가 필요합니다. 이 권한이 요청되기 전에 연결한 계정은 다시 연결할 때까지 consent_required로 응답합니다. Mac의 Mail 앱에 있는 계정의 폴더에는 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(선택)는 기존 폴더 안에 넣습니다. m365_list_email_folders의 id, 이름 또는 경로, 또는 inbox입니다. 같은 상위 폴더 아래에 같은 이름(대소문자 구분 없음)의 폴더가 이미 있으면 아무것도 만들지 않고 exists=true와 해당 id로 응답합니다. 먼저 미리보기를 표시하며, 만들려면 confirm=true로 설정하세요. Microsoft 365가 두 번째 읽기에서 새 폴더를 반환한 후에만 created=true로 응답합니다. Microsoft 365 권한 Mail.ReadWrite가 필요합니다. 이 권한이 요청되기 전에 연결한 계정은 다시 연결할 때까지 consent_required로 응답합니다. 이 PC의 클래식 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"
}