orgContact resource type

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.

JSON representation

Here is a JSON representation of the resource

  "businessPhones": ["string"],
  "city": "string",
  "companyName": "string",
  "country": "string",
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "jobTitle": "string",
  "mail": "string",
  "mailNickname": "string",
  "mobilePhone": "string",
  "officeLocation": "string",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSyncEnabled": true,
  "postalCode": "string",
  "proxyAddresses": ["string"],
  "state": "string",
  "streetAddress": "string",
  "surname": "string"


Property Type Description
city String The city in which the contact is located.
country String The country/region in which the contact is located.
department String The name for the department in which the contact works.
onPremisesSyncEnabled Boolean true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced; null if this object has never been synced from an on-premises directory (default).
displayName String The display name for the contact.
givenName String The given name (first name) of the contact.
jobTitle String The contact's job title.
onPremisesLastSyncDateTime DateTimeOffset Indicates the last time at which the object was synced with the on-premises directory. 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'
onPremisesProvisioningErrors onPremisesProvisioningError collection Errors when using Microsoft synchronization product during provisioning.
mail String The SMTP address for the contact, for example, "".
mailNickname String The mail alias for the contact.
mobilePhone String The primary cellular telephone number for the contact.
id String The unique identifier for the contact. Read-only.
officeLocation String The office location in the contact's place of business.
postalCode String The postal code for the contact's postal address. The postal code is specific to the contact's country/region. In the United States of America, this attribute contains the ZIP code.
proxyAddresses String collection For example: ["SMTP:", "smtp:"] The any operator is required for filter expressions on multi-valued properties. Read-only. Not nullable. Supports $filter.
state String The state or province in the contact's address.
streetAddress String The street address of the contact's place of business.
surname String The contact's surname (family name or last name).
businessPhones String The primary telephone number of the contact's place of business.


Relationship Type Description
directReports directoryObject collection The contact's direct reports. (The users and contacts that have their manager property set to this contact.) Read-only. Nullable.
manager directoryObject The user or contact that is this contact's manager. Read-only.
memberOf directoryObject collection Groups that this contact is a member of. Read-only. Nullable.


Method Return Type Description
Get orgContact orgContact Read properties and relationships of orgContact object.
Get manager directoryObject Get the contact's manager.
List directReports directoryObject collection List the contact's direct reports.
List memberOf directoryObject collection Get a memberOf object collection.
Delete None Delete orgContact object.
checkMemberGroups String collection Check for group membership.
getMemberGroups String collection Return all the groups that the specified contact is a member of.
getMemberObjects String collection Returns a list of directoryObjects the contact is a member of.