MailFolder を作成する

この API を使用して、新しいメール フォルダーを作成します。

前提条件

この API を実行するには、以下のいずれかのスコープが必要です。Mail.ReadWrite

HTTP 要求

POST /users/{id | userPrincipalName}/mailFolders

要求ヘッダー

ヘッダー
Authorization Bearer . Required.
Content-Type application/json

要求本文

要求本文で、次のパラメーターを含む JSON オブジェクトを指定します。MailFolder オブジェクトに対して書き込み可能なプロパティは displayName のみです。

パラメーター 説明
parentFolderId String 親フォルダーのフォルダー ID、あるいは InboxDraftsSentItems または DeletedItems の既知のフォルダー名です。
displayName String 新しいフォルダーの表示名です。

応答

成功した場合、このメソッドは 201, Created 応答コードと、応答本文で MailFolder オブジェクトを返します。

要求

以下は、要求の例です。

POST https://graph.microsoft.com/v1.0/me/mailFolders
Content-type: application/json
Content-length: 159

{
  "displayName": "displayName-value",
  "parentFolderId": "parentFolderId-value"
}
応答

以下は、応答の例です。注:簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。すべてのプロパティは実際の呼び出しから返されます。

HTTP/1.1 201 Created
Content-type: application/json
Content-length: 179

{
  "displayName": "displayName-value",
  "parentFolderId": "parentFolderId-value",
  "childFolderCount": 99,
  "unreadItemCount": 99,
  "totalItemCount": 99,
  "id": "id-value"
}