Create Contact

Important: APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported.

Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.


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

HTTP request

POST /me/contacts
POST /users/{id | userPrincipalName}/contacts
POST /me/contactFolders/{contactFolderId}/contacts
POST /users/{id | userPrincipalName}/contactFolders/{contactFolderId}/contacts

Request headers

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

Request body

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


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



Here is an example of the request.

Content-type: application/json

  "givenName": "Pavel",
  "surname": "Bansky",
  "emailAddresses": [
      "address": "",
      "name": "Pavel Bansky"
  "phones" : [
      "number": "+1 732 555 0102",
      "type": "business"

In the request body, supply a JSON representation of contact 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 201 Created
Content-type: application/json

  "id": "id-value",
  "createdDateTime": "2015-11-09T02:14:32Z",
  "lastModifiedDateTime": "2015-11-09T02:14:32Z",
   "displayName": "Pavel Bansky"

See also