Contacts.ReadWrite

Allows the app to create, read, update, and delete user contacts.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver	Type	Method
V1	A,D	DELETE /me/contactFolders/{id}
V1	A,D	DELETE /me/contacts/{id}
V1	A,D	DELETE /users/{id \| userPrincipalName}/contactFolders/{id}
V1	A,D	DELETE /users/{id \| userPrincipalName}/contacts/{id}
V1	A,D	GET /groups/{id}/photo/$value
V1	A,D	GET /me/contactFolders
V1	A,D	GET /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
V1	A,D	GET /me/contactFolders/{id}
V1	A,D	GET /me/contactFolders/{id}/childFolders
V1	A,D	GET /me/contactFolders/{id}/contacts
V1	A,D	GET /me/contactFolders/{id}/contacts/delta
V1	A,D	GET /me/contactFolders/delta
V1	A,D	GET /me/contacts
V1	A,D	GET /me/contacts/{id}
V1	A,D	GET /me/contacts/{id}/photo/$value
V1	A,D	GET /me/photo/$value
V1	A,D	GET /team/{id}/photo/$value
V1	A,D	GET /users/{id \| userPrincipalName}/contactFolders
V1	A,D	GET /users/{id \| userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
V1	A,D	GET /users/{id \| userPrincipalName}/contactFolders/{id}
V1	A,D	GET /users/{id \| userPrincipalName}/contactFolders/{id}/childFolders
V1	A,D	GET /users/{id \| userPrincipalName}/contactFolders/{id}/contacts
V1	A,D	GET /users/{id \| userPrincipalName}/contacts
V1	A,D	GET /users/{id \| userPrincipalName}/contacts/{id}
V1	A,D	GET /users/{id \| userPrincipalName}/contacts/{id}/photo/$value
V1	A,D	GET /users/{id \| userPrincipalName}/photo/$value
V1	A,D	GET /users/{id}/contactFolders/{id}/contacts/delta
V1	A,D	GET /users/{id}/contactFolders/delta
V1	A,D	PATCH /groups/{id}/photo/$value
V1	A,D	PATCH /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
V1	A,D	PATCH /me/contactFolders/{id}
V1	A,D	PATCH /me/contacts/{id}
V1	A,D	PATCH /me/contacts/{id}/photo/$value
V1	A,D	PATCH /me/photo/$value
V1	A,D	PATCH /users/{id \| userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
V1	A,D	PATCH /users/{id \| userPrincipalName}/contactFolders/{id}
V1	A,D	PATCH /users/{id \| userPrincipalName}/contacts/{id}
V1	A,D	PATCH /users/{id \| userPrincipalName}/contacts/{id}/photo/$value
V1	A,D	PATCH /users/{id \| userPrincipalName}/photo/$value
V1	A,D	POST /me/contactFolders
V1	A,D	POST /me/contactFolders/{contactFolderId}/contacts
V1	A,D	POST /me/contactFolders/{id}/childFolders
V1	A,D	POST /me/contactFolders/{id}/contacts
V1	A,D	POST /me/contacts
V1	A,D	POST /users/{id \| userPrincipalName}/contactFolders
V1	A,D	POST /users/{id \| userPrincipalName}/contactFolders/{contactFolderId}/contacts
V1	A,D	POST /users/{id \| userPrincipalName}/contactFolders/{id}/childFolders
V1	A,D	POST /users/{id \| userPrincipalName}/contactFolders/{id}/contacts
V1	A,D	POST /users/{id \| userPrincipalName}/contacts
V1	A,D	PUT /groups/{id}/photo/$value
V1	A,D	PUT /me/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
V1	A,D	PUT /me/contacts/{id}/photo/$value
V1	A,D	PUT /me/photo/$value
V1	A,D	PUT /team/{id}/photo/$value
V1	A,D	PUT /users/{id \| userPrincipalName}/contactfolders/{contactFolderId}/contacts/{id}/photo/$value
V1	A,D	PUT /users/{id \| userPrincipalName}/contacts/{id}/photo/$value
V1	A,D	PUT /users/{id \| userPrincipalName}/photo/$value

Delegate Permission


Id	d56682ec-c09e-4743-aaf4-1a3aac4caa21
Consent Type	User
Display String	Have full access to user contacts
Description	Allows the app to create, read, update, and delete user contacts.

Application Permission


Id	6918b873-d17a-4dc1-b314-35f528134491
Display String	Read and write contacts in all mailboxes
Description	Allows the app to create, read, update, and delete all contacts in all mailboxes without a signed-in user.

Resources

contact

Property	Type	Description
assistantName	String	The name of the contact's assistant.
birthday	DateTimeOffset	The contact's birthday. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
businessAddress	PhysicalAddress	The contact's business address.
businessHomePage	String	The business home page of the contact.
businessPhones	String collection	The contact's business phone numbers.
categories	String collection	The categories associated with the contact.
changeKey	String	Identifies the version of the contact. Every time the contact is changed, ChangeKey changes as well. This allows Exchange to apply changes to the correct version of the object.
children	String collection	The names of the contact's children.
companyName	String	The name of the contact's company.
createdDateTime	DateTimeOffset	The time the contact was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
department	String	The contact's department.
displayName	String	The contact's display name. You can specify the display name in a create or update operation. Note that later updates to other properties may cause an automatically generated value to overwrite the displayName value you have specified. To preserve a pre-existing value, always include it as displayName in an update operation.
emailAddresses	EmailAddress collection	The contact's email addresses.
fileAs	String	The name the contact is filed under.
generation	String	The contact's generation.
givenName	String	The contact's given name.
homeAddress	PhysicalAddress	The contact's home address.
homePhones	String collection	The contact's home phone numbers.
id	String	The contact's unique identifier. !INCLUDE [outlook-beta-id] Read-only.
imAddresses	String collection	The contact's instant messaging (IM) addresses.
initials	String	The contact's initials.
jobTitle	String	The contact’s job title.
lastModifiedDateTime	DateTimeOffset	The time the contact was modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`
manager	String	The name of the contact's manager.
middleName	String	The contact's middle name.
mobilePhone	String	The contact's mobile phone number.
nickName	String	The contact's nickname.
officeLocation	String	The location of the contact's office.
otherAddress	PhysicalAddress	Other addresses for the contact.
parentFolderId	String	The ID of the contact's parent folder.
personalNotes	String	The user's notes about the contact.
profession	String	The contact's profession.
spouseName	String	The name of the contact's spouse/partner.
surname	String	The contact's surname.
title	String	The contact's title.
yomiCompanyName	String	The phonetic Japanese company name of the contact.
yomiGivenName	String	The phonetic Japanese given name (first name) of the contact.
yomiSurname	String	The phonetic Japanese surname (last name) of the contact.

contactFolder

Property	Type	Description
displayName	String	The folder's display name.
id	String	Unique identifier of the contact folder. Read-only.
parentFolderId	String	The ID of the folder's parent folder.

emailAddress

Property	Type	Description
address	String	The email address of the person or entity.
name	String	The display name of the person or entity.

mailFolder

Property	Type	Description
childFolderCount	Int32	The number of immediate child mailFolders in the current mailFolder.
displayName	String	The mailFolder's display name.
id	String	The mailFolder's unique identifier.
isHidden	Boolean	Indicates whether the mailFolder is hidden. This property can be set only when creating the folder. Find more information in Hidden mail folders.
parentFolderId	String	The unique identifier for the mailFolder's parent mailFolder.
totalItemCount	Int32	The number of items in the mailFolder.
unreadItemCount	Int32	The number of items in the mailFolder marked as unread.

phone

Property	Type	Description
number	string	The phone number.
type	phoneType	The type of phone number. The possible values are: `home`, `business`, `mobile`, `other`, `assistant`, `homeFax`, `businessFax`, `otherFax`, `pager`, `radio`.

physicalAddress

Property	Type	Description
city	String	The city.
countryOrRegion	String	The country or region. It's a free-format string value, for example, "United States".
postalCode	String	The postal code.
state	String	The state.
street	String	The street.

profilePhoto

Property	Type	Description
id	string	Read-only.
height	int32	The height of the photo. Read-only.
width	int32	The width of the photo. Read-only.

typedEmailAddress

Property	Type	Description
address	String	The email address of a contact.
name	String	The display name of a contact.
type	String	The type of email address. Possible values are: `unknown`, `work`, `personal`, `main`, `other`. The default value is `unknown`, which means address has not been set as a specific type.
otherLabel	String	To specify a custom type of email address, set **t

website

Property	Type	Description
address	string	The URL of the website.
displayName	string	The display name of the web site.
type	websiteType	The possible values are: `other`, `home`, `work`, `blog`, `profile`.