MailFolder を作成する

この API を使用して、新しい子 mailFolder を作成します。

前提条件

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

HTTP 要求

POST /me/mailFolders/{id}/childFolders
POST /users/{id | userPrincipalName}/mailFolders/{id}/childFolders

クエリの URL 内の親フォルダーをフォルダー ID、または InboxDraftsSentItems、や DeletedItems のよく知られているフォルダー名として指定します。

要求ヘッダー

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

要求本文

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

パラメーター 説明
displayName String 新しいフォルダーの表示名です。

応答

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

要求

以下は、要求の例です。

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

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

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

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 179

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