orgContact resource type

Namespace: microsoft.graph


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

Represents an organizational contact. Organizational contacts are managed by an organization's administrators and are different from personal contacts. Additionally, organizational contacts are either synchronized from on-premises directories or from Exchange Online, and are read-only.

Inherits from directoryObject.

This resource supports using delta query to track incremental additions, deletions, and updates, by providing a delta function.


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.


Property Type Description
addresses physicalOfficeAddress collection Postal addresses for this organizational contact. For now a contact can only have one physical address.
companyName String Name of the company that this organizational contact belong to.
department String The name for the department in which the contact works.
displayName String Display name for this organizational contact.
givenName String First name for this organizational contact.
id String Unique identifier for this organizational contact.
jobTitle String Job title for this organizational contact.
mail String The SMTP address for the contact, for example, "".
mailNickname String Email alias (portion of email address pre-pending the @ symbol) for this organizational contact.
onPremisesLastSyncDateTime DateTimeOffset Date and time when this organizational contact was last synchronized from on-premises AD. 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 List of any synchronization provisioning errors for this organizational contact.
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 and now mastered in Exchange; null if this object has never been synced from an on-premises directory (default).
phones phone collection List of phones for this organizational contact. Phone types can be mobile, business, and businessFax. Only one of each type can ever be present in the collection.
proxyAddresses String collection For example: "SMTP:", "smtp:". The any operator is required for filter expressions on multi-valued properties. Supports $filter.
surname String Last name for this organizational contact.


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.

JSON representation

Here is a JSON representation of the resource

  "addresses": [{"@odata.type": "microsoft.graph.physicalOfficeAddress"}],
  "companyName": "string",
  "department": "string",
  "displayName": "string",
  "givenName": "string",
  "id": "string (identifier)",
  "jobTitle": "string",
  "mail": "string",
  "mailNickname": "string",
  "onPremisesLastSyncDateTime": "string (timestamp)",
  "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
  "onPremisesSyncEnabled": true,
  "phones": [{"@odata.type": ""}],
  "proxyAddresses": ["string"],
  "surname": "string"