OrgContact.Read.All

Allows the app to read all organizational contacts on behalf of the signed-in user.  These contacts are managed by the organization and are different from a user's personal contacts.

Graph Methods

Type: A = Application Permission, D = Delegate Permission

Ver Type Method
V1 A,D GET /contacts
V1 A,D GET /contacts/{id}
V1 A,D GET /contacts/{id}/directReports
V1 A,D GET /contacts/{id}/manager
V1 A,D GET /contacts/{id}/memberOf
V1 A,D GET /contacts/{id}/transitiveMemberOf
Beta A,D GET /contacts/{id}/transitiveReports/$count
V1 A,D GET /contacts/delta
V1 A,D POST /contacts/{id}/checkMemberGroups
V1 A,D POST /contacts/{id}/getMemberGroups
V1 A,D POST /contacts/{id}/getMemberObjects

Delegate Permission
Id 08432d1b-5911-483c-86df-7980af5cdee0
Consent Type Admin
Display String Read organizational contacts
Description Allows the app to read all organizational contacts on behalf of the signed-in user.  These contacts are managed by the organization and are different from a user's personal contacts.

Application Permission
Id e1a88a34-94c4-4418-be12-c87b00e26bea
Display String Read organizational contacts
Description Allows the app to read all organizational contacts without a signed-in user. These contacts are managed by the organization and are different from a user's personal contacts.

Resources

directoryObject

Property Type Description
id String The unique identifier for the object. For example, 12345678-9abc-def0-1234-56789abcde. The value of the **i

orgContact

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 belongs to. Supports $filter (eq, ne, NOT, ge, le, in, startsWith).
department String The name for the department in which the contact works. Supports $filter (eq, ne, NOT, ge, le, in, startsWith).
displayName String Display name for this organizational contact. Supports $filter (eq, ne, NOT, ge, le, in, startsWith), $search, and $orderBy.
givenName String First name for this organizational contact. Supports $filter (eq, ne, NOT, ge, le, in, startsWith).
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).
mail String The SMTP address for the contact, for example, "jeff@contoso.onmicrosoft.com". Supports $filter (eq, ne, NOT, ge, le, in, startsWith).
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).
onPremisesLastSyncDateTime DateTimeOffset Date and time when this organizational contact was last synchronized from on-premises AD. This date and time information uses 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).
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).
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: 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).
surname String Last name for this organizational contact. Supports $filter (eq, ne, NOT, ge, le, in, startsWith).