contact resource type

A contact is an item in Outlook where you can organize and save information about the people and organizations you communicate with. Contacts are contained in contact folders.

Methods

Method Return Type Description
Get contact contact Read properties and relationships of contact object.
Create contact Add a contact to the root Contacts folder or to the contacts endpoint of another contact folder.
Update contact Update contact object.
Delete None Delete contact object.
Create data extension openTypeExtension Create an open type data extension and add custom properties in a new or existing instance of a resource.
Get data extension openTypeExtension collection Get an openTypeExtension object or objects identified by name or fully qualified name.
Create single-value extended property contact Create one or more single-value extended properties in a new or existing contact.
Get contact with single-value extended property contact Get contacts that contain a single-value extended property by using $expand or $filter.
Create multi-value extended property contact Create one or more multi-value extended properties in a new or existing contact.
Get contact with multi-value extended property contact Get a contact that contains a multi-value extended property by using $expand.

Properties

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 would look like this: '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 would look like this: '2014-01-01T00:00:00Z'
department String The contact's department.
displayName String The contact's display name.
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. 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 would look like this: '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.
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.

Relationships

Relationship Type Description
extensions extension collection The collection of open type data extensions defined for the contact. Read-only. Nullable.
multiValueExtendedProperties multiValueLegacyExtendedProperty collection The collection of multi-value extended properties defined for the contact. Read-only. Nullable.
photo profilePhoto Optional contact picture. You can get or set a photo for a contact.
singleValueExtendedProperties singleValueLegacyExtendedProperty collection The collection of single-value extended properties defined for the contact. Read-only. Nullable.

JSON representation

Here is a JSON representation of the resource

{
  "assistantName": "string",
  "birthday": "String (timestamp)",
  "businessAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "businessHomePage": "string",
  "businessPhones": ["string"],
  "categories": ["string"],
  "changeKey": "string",
  "children": ["string"],
  "companyName": "string",
  "createdDateTime": "String (timestamp)",
  "department": "string",
  "displayName": "string",
  "emailAddresses": [{"@odata.type": "microsoft.graph.emailAddress"}],
  "fileAs": "string",
  "generation": "string",
  "givenName": "string",
  "homeAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "homePhones": ["string"],
  "id": "string (identifier)",
  "imAddresses": ["string"],
  "initials": "string",
  "jobTitle": "string",
  "lastModifiedDateTime": "String (timestamp)",
  "manager": "string",
  "middleName": "string",
  "mobilePhone": "string",
  "nickName": "string",
  "officeLocation": "string",
  "otherAddress": {"@odata.type": "microsoft.graph.physicalAddress"},
  "parentFolderId": "string",
  "personalNotes": "string",
  "profession": "string",
  "spouseName": "string",
  "surname": "string",
  "title": "string",
  "yomiCompanyName": "string",
  "yomiGivenName": "string",
  "yomiSurname": "string",

  "photo": { "@odata.type": "microsoft.graph.profilePhoto" }
}