Office 365 Users

Office 365 Users Connection provider lets you access user profiles in your organization using your Office 365 account. You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports and also update a user profile.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

To use this connector in PowerApps, learn more here.

Known Issues and Limitations

The followings are some of the known limitations of using Office 365 Users connector

  1. Get manager action returns "No manager found for the specified user".

    • This happens when the user does not have a manager configured in AAD. Learn how to update an AAD user's profile to configure a manager here.
  2. Get direct reports, Get manager, Get my profile and Get user profile actions declare an input parameter Select fields. You can specify a coma separated list of fields to select in this parameter (learn more about available fields here). For example:

    • department, jobTitle
    • displayName, surname, mailNickname, userPrincipalName

    If the parameter is not specified, the following fields are selected by default: aboutMe, accountEnabled, birthday, businessPhones, city, companyName, country, department, displayName, givenName, hireDate, id, interests, jobTitle, mail, mailNickname, mobilePhone, mySite, officeLocation, pastProjects, postalCode, preferredLanguage, preferredName, responsibilities, schools, skills, state, streetAddress, surname, userPrincipalName, userType.

Throttling Limits

Name Calls Renewal Period
API calls per connection100060 seconds

Actions

Get direct reports (V1) [DEPRECATED]

Retrieves the user profiles of the specified user's direct reports. This action has been deprecated. Please use DirectReports_V2 instead.

Get direct reports (V2)

Retrieves the user profiles of the specified user's direct reports. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Get manager (V1) [DEPRECATED]

Retrieves the profile of the specified user's manager. This action has been deprecated. Please use Manager_V2 instead.

Get manager (V2)

Retrieves the profile of the specified user's manager. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Get my profile (V1) [DEPRECATED]

Retrieves the profile of the current user. This action has been deprecated. Please use MyProfile_V2 instead.

Get my profile (V2)

Retrieves the profile of the current user. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Get my trending documents

Retrieves the trending documents for the signed in user

Get relevant people

Get relevant people.

Get trending documents

Retrieves the trending documents for a user

Get user photo (V1) [DEPRECATED]

Retrieves the photo of the specified user if they have one. This action has been deprecated. Please use UserPhoto_V2 instead.

Get user photo (V2)

Retrieves the photo of the specified user if they have one

Get user photo metadata

Get user photo metadata.

Get user profile (V1) [DEPRECATED]

Retrieves the profile of a specific user. This action has been deprecated. Please use UserProfile_V2 instead.

Get user profile (V2)

Retrieves the profile of a specific user. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Search for users

Retrieves the user profiles that match the search term.

Update my profile

Updates the profile of the current user

Update my profile photo

Updates the profile photo of the current user. The size of the photo must be less than 4 MB.

Get direct reports (V1) [DEPRECATED]

Retrieves the user profiles of the specified user's direct reports. This action has been deprecated. Please use DirectReports_V2 instead.

Parameters

Name Key Required Type Description
User (UPN)
userId True string

User principal name or email id.

Returns

response
array of User

Get direct reports (V2)

Retrieves the user profiles of the specified user's direct reports. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Parameters

Name Key Required Type Description
User (UPN)
id True string

User principal name or email id

Select fields
$select string

Comma separated list of fields to select. Example: surname, department, jobTitle

Top
$top integer

Limit on the number of results to return. By default returns all entries.

Returns

Name Path Type Description
value
value array of GraphUser_V1

Value

Get manager (V1) [DEPRECATED]

Retrieves the profile of the specified user's manager. This action has been deprecated. Please use Manager_V2 instead.

Parameters

Name Key Required Type Description
User (UPN)
userId True string

User principal name or email id.

Returns

Represents a User object in the directory

Body
User

Get manager (V2)

Retrieves the profile of the specified user's manager. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Parameters

Name Key Required Type Description
User (UPN)
id True string

User principal name or email id

Select fields
$select string

Comma separated list of fields to select. Example: surname, department, jobTitle

Returns

User from Graph API

Get my profile (V1) [DEPRECATED]

Retrieves the profile of the current user. This action has been deprecated. Please use MyProfile_V2 instead.

Returns

Represents a User object in the directory

Body
User

Get my profile (V2)

Retrieves the profile of the current user. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Parameters

Name Key Required Type Description
Select fields
$select string

Comma separated list of fields to select. Example: surname, department, jobTitle

Returns

User from Graph API

Retrieves the trending documents for the signed in user

Parameters

Name Key Required Type Description
Filter query
$filter string

An OData filter to filter the resources selected. Filter selected resources on ResourceVisualization/Type or ResourceVisualization/containerType

Returns

Name Path Type Description
value
value array of GraphTrending

value

Get relevant people

Get relevant people.

Parameters

Name Key Required Type Description
User (UPN)
userId True string

User principal name or email id.

Returns

Represents a list from the Graph API

Retrieves the trending documents for a user

Parameters

Name Key Required Type Description
User (UPN)
id True string

User principal name or email id

Filter query
$filter string

An OData filter to filter the resources selected. Filter selected resources on ResourceVisualization/Type or ResourceVisualization/containerType

Returns

Name Path Type Description
value
value array of GraphTrending

value

Get user photo (V1) [DEPRECATED]

Retrieves the photo of the specified user if they have one. This action has been deprecated. Please use UserPhoto_V2 instead.

Parameters

Name Key Required Type Description
User (UPN)
userId True string

User principal name or email id.

Returns

Image file content
binary

Get user photo (V2)

Retrieves the photo of the specified user if they have one

Parameters

Name Key Required Type Description
User (UPN)
id True string

User principal name or email id

Returns

Image file content
binary

Get user photo metadata

Get user photo metadata.

Parameters

Name Key Required Type Description
User (UPN)
userId True string

User principal name or email id.

Returns

Photo Metadata class

Get user profile (V1) [DEPRECATED]

Retrieves the profile of a specific user. This action has been deprecated. Please use UserProfile_V2 instead.

Parameters

Name Key Required Type Description
User (UPN)
userId True string

User principal name or email id.

Returns

Represents a User object in the directory

Body
User

Get user profile (V2)

Retrieves the profile of a specific user. Learn more about available fields to select: https://developer.microsoft.com/en-us/graph/docs/api-reference/v1.0/resources/user#properties

Parameters

Name Key Required Type Description
User (UPN)
id True string

User principal name or email id

Select fields
$select string

Comma separated list of fields to select. Example: surname, department, jobTitle

Returns

User from Graph API

Search for users

Retrieves the user profiles that match the search term.

Parameters

Name Key Required Type Description
Search term
searchTerm string

Search string (applies to: display name, given name, surname, mail, mail nickname and user principal name).

Top
top integer

Limit on the number of results to return. By default returns all entries.

Returns

response
array of User

Update my profile

Updates the profile of the current user

Parameters

Name Key Required Type Description
About Me
aboutMe string

About Me

Birthday
birthday date-time

Birthday

Interests
Interests string

About Me

My Site
mySite string

My Site

Past Projects
Past Projects string

About Me

Schools
Schools string

About Me

Skills
Skills string

About Me

Update my profile photo

Updates the profile photo of the current user. The size of the photo must be less than 4 MB.

Parameters

Name Key Required Type Description
Image content
body True binary

Image content

Content-Type
Content-Type True string

Image content type (like 'image/jpeg')

Definitions

LinklessEntityListResponse[List[Person]]

Represents a list from the Graph API

Name Path Type Description
value
value array of Person

Value

Person

Represents a Person

Name Path Type Description
Person id
id string

A unique identifier for the Person object in the directory

Display name
displayName string

The person's display name

Given name
givenName string

The person's given name

Surname
surname string

The person's surname

Birthday
birthday string

The person's birthday

Person Notes
personNotes string

Free-form notes that the current user has taken about this person

Is Favorite?
isFavorite boolean

If the current user has flagged this person as a favorite

Job title
jobTitle string

The person's job title

Company name
companyName string

The name of the person's company

Department
department string

The person's department

Office location
officeLocation string

The location of the person's office

Profession
profession string

The person's profession

User Principal Name (UPN)
userPrincipalName string

The user principal name(UPN) of the user.The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name.The general format is alias @domain, where domain must be present in the tenant's collection of verified domains.

IM Address
imAddress string

The person's VOIP SIP address

Scored Email Addresses
scoredEmailAddresses array of ScoredEmailAddress

Collection of the person's email addresses with a relevance score

Phones
phones array of Phone

The person's phone numbers

ScoredEmailAddress

Represents a scored email address

Name Path Type Description
Email Address
address string

The email address

Relevance Score
relevanceScore double

The relevance score of the email address. A relevance score is used as a sort key, in relation to the other returned results. A higher relevance score value corresponds to a more relevant result. Relevance is determined by the user's communication and collaboration patterns and business relationships.

Phone

Represents a phone number

Name Path Type Description
Phone Number
number string

The phone number

Phone Type
type string

The type of phone number. Possible values: home, business, mobile, other, assistant, homeFax, businessFax, otherFax, pager, radio.

User

Represents a User object in the directory

Name Path Type Description
User id
Id string

A unique identifier for the user object in the directory.

Account enabled?
AccountEnabled boolean

true if the account is enabled; otherwise, false. This property is required when a user is created.

Business phones
BusinessPhones array of string

A list of business phone numbers for the user

City
City string

The city in which the user is located.

Company name
CompanyName string

The name of the company in which the user works.

Country
Country string

The country/region in which the user is located; for example, "US" or "UK".

Department
Department string

The name of the department in which the user works.

Display name
DisplayName string

The name displayed in the address book for the user. This is usually the combination of the user's first name, middle initial and last name. This property is required when a user is created and it cannot be cleared during updates.

Given name
GivenName string

The given name (first name) of the user.

Job title
JobTitle string

The user’s job title.

Email
Mail string

The SMTP/email address for the user, for example, "jeff@contoso.onmicrosoft.com". Read-Only.

Nickname
MailNickname string

The mail alias for the user. This property must be specified when a user is created.

Office location
OfficeLocation string

The office location in the user's place of business.

Postal code
PostalCode string

The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code.

Surname
Surname string

The user's surname (family name or last name).

Telephone number
TelephoneNumber string

The primary cellular telephone number for the user.

User Principal Name (UPN)
UserPrincipalName string

The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user’s email name. The general format is alias@domain, where domain must be present in the tenant’s collection of verified domains.

ClientPhotoMetadata

Photo Metadata class

Name Path Type Description
Has photo
HasPhoto boolean

Has photo

Height
Height integer

Height of photo

Width
Width integer

Width of photo

ContentType
ContentType string

Content Type of photo

Image File Extension
ImageFileExtension string

File extension for the photo (ex: ".jpg")

GraphUser_V1

User from Graph API

Name Path Type Description
About Me
aboutMe string

About Me

Account enabled?
accountEnabled boolean

true if the account is enabled; otherwise, false. This property is required when a user is created.

Birthday
birthday date-time

Birthday

Business Phones
businessPhones array of string

Business Phones

City
city string

The city in which the user is located.

Company name
companyName string

The name of the company in which the user works.

Country
country string

The country/region in which the user is located; for example, "US" or "UK".

Department
department string

The name of the department in which the user works.

Display Name
displayName string

Display Name

Given Name
givenName string

Given Name

Hire Date
hireDate date-time

Hire Date

Id
id string

Id

Interests
interests array of string

Interests

Job Title
jobTitle string

Job Title

Mail
mail string

Mail

Nickname
mailNickname string

The mail alias for the user. This property must be specified when a user is created.

Mobile Phone
mobilePhone string

Mobile Phone

My Site
mySite string

My Site

Office Location
officeLocation string

Office Location

Past Projects
pastProjects array of string

Past Projects

Postal code
postalCode string

The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code.

Preferred Language
preferredLanguage string

Preferred Language

Preferred Name
preferredName string

Preferred Name

Responsibilities
responsibilities array of string

Responsibilities

Schools
schools array of string

Schools

Skills
skills array of string

Skills

State
state string

State

Street Address
streetAddress string

Street Address

Surname
surname string

Surname

User Principal Name
userPrincipalName string

User Principal Name

User Type
userType string

User Type

GraphTrending

Trending documents from Graph API

Name Path Type Description
Id
id string

Unique identifier of the relationship

Weight
weight float

Value indicating how much the document is currently trending

Title
resourceVisualization.title string

The item's title text

Type
resourceVisualization.type string

The item's media type (can be used for filtering for a specific file based on a specific type)

Media type
resourceVisualization.mediaType string

The items media type (can be used for filtering for a specific type of file based on supported IANA Media MIME types)

Preview image URL
resourceVisualization.previewImageUrl string

A URL leading to the preview image for the item

Preview text
resourceVisualization.previewText string

A preview text for the item

Container web URL
resourceVisualization.containerWebUrl string

A path leading to the folder in which the item is stored

Container display name
resourceVisualization.containerDisplayName string

A string describing where the item is stored

Container type
resourceVisualization.containerType string

Can be used for filtering by the type of container in which the file is stored

Web URL
resourceReference.webUrl string

A URL leading to the referenced item

Id
resourceReference.id string

The item's unique identifier

Type
resourceReference.type string

A string value that can be used to classify the item, such as "microsoft.graph.driveItem"