Edit

Share via

orgContact resource type

  • Article

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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 in Microsoft Graph.

Inherits from directoryObject.

This resource supports using delta query to track incremental additions, deletions, and updates, by providing a delta function. This resource is an open type that allows other properties to be passed in.

Methods

Method Return Type Description
Organizational contacts
List orgContact collection List properties of organizational contacts.
Get orgContact Read properties and relationships of orgContact object.
Get delta orgContact collection Get newly created, updated, or deleted organizational contacts without having to perform a full read of the entire collection.
Get delta for directory object direcyoryObject collection Get newly created, updated, or deleted organizational contacts via the directory object collection without having to perform a full read of the entire collection.
List member of String collection Retrieve the list of groups and adminstrative units the contact is a member of. The check is transitive.
List transitive member of directoryObject collection List the groups an organizational contact is a member of, including groups that the organizational contact is nested under.
Check member groups String collection Check for membership of an organizational contact in a list of groups. The check is transitive.
Get member groups String collection Return all the groups that the organizational contact is a member of. The check is transitive.
Check member objects String collection Check for membership of an organizational contact in a list of groups, directory role, or administrative unit objects.
Get member objects String collection Return all groups, administrative units, and directory roles that the organizational contact is a member of. The check is transitive.
Retry service provisioning None Retry the orgContact service provisioning.
Get transitive reports Integer Get the count of transitive reports for an organization contact from the transitiveReports navigation property.
Organizational hierarchy
Get manager directoryObject Get the contact's manager.
List direct reports directoryObject collection List the contact's direct reports.

Properties

Important

Specific usage of $filter and the $search query parameter is supported only when you use the ConsistencyLevel header set to eventual and $count. For more information, see Advanced query capabilities on directory objects.

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. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq for null values).
department String The name for the department in which the contact works. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq for null values).
displayName String Display name for this organizational contact. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq for null values), $search, and $orderby.
givenName String First name for this organizational contact. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq for null values).
id String Unique identifier for this organizational contact. Supports $filter (eq, ne, not, in).
jobTitle String Job title for this organizational contact. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq for null values).
mail String The SMTP address for the contact, for example, "[email protected]". Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq for null values).
mailNickname String Email alias (portion of email address pre-pending the @ symbol) for this organizational contact. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq for null values).
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 is 2014-01-01T00:00:00Z. Supports $filter (eq, ne, not, ge, le, in).
onPremisesProvisioningErrors onPremisesProvisioningError collection List of any synchronization provisioning errors for this organizational contact. Supports $filter (eq, not for category and propertyCausingError), /$count eq 0, /$count ne 0.
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).

Supports $filter (eq, ne, not, in, and eq for null values).
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. Supports $filter (eq, ne, not, in).
proxyAddresses String collection For example: "SMTP: [email protected]", "smtp: [email protected]". The any operator is required for filter expressions on multi-valued properties. Supports $filter (eq, not, ge, le, startsWith, /$count eq 0, /$count ne 0).
serviceProvisioningErrors serviceProvisioningError collection Errors published by a federated service describing a non-transient, service-specific error regarding the properties or link from an orgContact object .
Supports $filter (eq, not, for isResolved and serviceInstance).
surname String Last name for this organizational contact. Supports $filter (eq, ne, not, ge, le, in, startsWith, and eq for null values)

Relationships

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. Supports $expand.
manager directoryObject The user or contact that is this contact's manager. Read-only. Supports $expand and $filter (eq) by id.
memberOf directoryObject collection Groups that this contact is a member of. Read-only. Nullable. Supports $expand.
transitiveReports directoryObject collection The transitive reports for a contact. Read-only.

JSON representation

The following JSON representation shows the resource type.

{
  "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": "microsoft.graph.phone"}],
  "proxyAddresses": ["string"],
  "serviceProvisioningErrors": [{"@odata.type": "microsoft.graph.serviceProvisioningXmlError"}],
  "surname": "string"
}