orgContact resource type

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 organizational contacts	orgContact collection	List properties of organizational contacts.
Get organizational contact	orgContact	Read properties and relationships of orgContact object.
Organizational hierarchy
Get manager	directoryObject	Get the contact's manager.
Get transitiveReports	Integer	Get the count of transitive reports for an organization contact from the transitiveReports navigation property.
List directReports	directoryObject collection	List the contact's direct reports.
List memberOf	directoryObject collection	Get a memberOf object collection.
checkMemberGroups	String collection	Check for group membership.
getMemberGroups	String collection	Return all the groups that the specified contact is a member of.
checkMemberObjects	String collection	Check for membership in groups, administrative units, and directory roles.
getMemberObjects	String collection	Get the list of groups, administrative units, and directory roles the contact is a member of.

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 Azure AD 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, "jeff@contoso.onmicrosoft.com". 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: bob@contoso.com", "smtp: bob@sales.contoso.com". 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

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