Create ContactFolder

Create a new contactFolder as a child of a specified folder.

You can also create a new contactFolder under the user's default contact folder.


One of the following scopes is required to execute this API: Contacts.ReadWrite

HTTP request

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

Request headers

Header Value
Authorization Bearer . Required.
Content-Type application/json. Required.

Request body

In the request body, supply a JSON representation of ContactFolder object.


If successful, this method returns 201, Created response code and ContactFolder object in the response body.



Here is an example of the request.

Content-type: application/json
Content-length: 84

  "displayName": "displayName-value"

In the request body, supply a JSON representation of contactFolder object.


Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

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

  "parentFolderId": "parentFolderId-value",
  "displayName": "displayName-value",
  "id": "id-value"