Office 365 Users

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.

To use this connector in PowerApps, learn more here.

Throttling Limits

Name Calls Renewal Period
API calls per connection 300 60 seconds

Actions

Get direct reports (V1)

Retrieves the user profiles of the specified user's direct reports.

Required Parameters

User (UPN)
string
User principal name or email id.

Returns

array of User

Get direct reports (V2)

Retrieves the user profiles of the specified user's direct reports

Required Parameters

User (UPN)
string
User principal name or email id

Optional Parameters

Select fields
string
Fields to select
Top
integer
Limit on the number of results to return. By default returns all entries.

Returns

value
array of GraphUser_V1
Value

Get manager (V1)

Retrieves the profile of the specified user's manager.

Required Parameters

User (UPN)
string
User principal name or email id.

Returns

Body
User

Represents a User object in the directory

Get manager (V2)

Retrieves the profile of the specified user's manager

Required Parameters

User (UPN)
string
User principal name or email id

Optional Parameters

Select fields
string
Fields to select

Returns

Body
GraphUser_V1

User from Graph API

Get my profile (V1)

Retrieves the profile of the current user.

Required Parameters

User (UPN)
string
User principal name or email id.

Returns

Body
User

Represents a User object in the directory

Get my profile (V2)

Retrieves the profile of the current user

Optional Parameters

Select fields
string
Fields to select

Returns

Body
GraphUser_V1

User from Graph API

Retrieves the trending documents for the signed in user

Optional Parameters

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

Returns

value
array of GraphTrending
value

Get relevant people

Get relevant people.

Required Parameters

User (UPN)
string
User principal name or email id.

Returns

Body
LinklessEntityListResponse[List[Person]]

Represents a list from the Graph API

Retrieves the trending documents for a user

Required Parameters

User (UPN)
string
User principal name or email id

Optional Parameters

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

Returns

value
array of GraphTrending
value

Get user photo (V1)

Retrieves the photo of the specified user if they have one.

Required Parameters

User (UPN)
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

Required Parameters

User (UPN)
string
User principal name or email id

Returns

Image file content
binary

Get user photo metadata

Get user photo metadata.

Required Parameters

User (UPN)
string
User principal name or email id.

Returns

Body
ClientPhotoMetadata

Photo Metadata class

Get user profile (V1)

Retrieves the profile of a specific user.

Required Parameters

User (UPN)
string
User principal name or email id.

Returns

Body
User

Represents a User object in the directory

Get user profile (V2)

Retrieves the profile of a specific user

Required Parameters

User (UPN)
string
User principal name or email id

Optional Parameters

Select fields
string
Fields to select

Returns

Body
GraphUser_V1

User from Graph API

Search for users

Retrieves the user profiles that match the search term.

Optional Parameters

Search term
string
Search string (applies to: display name, given name, surname, mail, mail nickname and user principal name).
Top
integer
Limit on the number of results to return. By default returns all entries.

Returns

array of User

Update my profile

Updates the profile of the current user

Optional Parameters

About Me
string
About Me
Birthday
date-time
Birthday
Interests
string
My Site
string
My Site
Past Projects
string
Schools
string
Skills
string

Returns

array of User

Update my profile photo

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

Required Parameters

Image content
binary
Image content
Content-Type
string
Image content type (like 'image/jpeg')

Returns

array of User

Definitions

LinklessEntityListResponse[List[Person]]

Represents a list from the Graph API

value
array of Person
Value

Person

Represents a Person

Birthday
string
The person's birthday
Company name
string
The name of the person's company
Department
string
The person's department
Display name
string
The person's display name
Given name
string
The person's given name
IM Address
string
The person's VOIP SIP address
Is Favorite?
string
If the current user has flagged this person as a favorite
Job title
string
The person's job title
Office location
string
The location of the person's office
Person Notes
string
Free-form notes that the current user has taken about this person
Person id
string
A unique identifier for the Person object in the directory
Phones
array of Phone
The person's phone numbers
Profession
string
The person's profession
Scored Email Addresses
array of ScoredEmailAddress
Collection of the person's email addresses with a relevance score
Surname
string
The person's surname
User Principal Name (UPN)
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.

ScoredEmailAddress

Represents a scored email address

Email Address
string
The email address
Relevance Score
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

Phone Number
string
The phone number
Phone 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

Account enabled?
boolean
true if the account is enabled; otherwise, false. This property is required when a user is created.
Business phones
array of string
A list of business phone numbers for the user
City
string
The city in which the user is located.
Company name
string
The name of the company in which the user works.
Country
string
The country/region in which the user is located; for example, "US" or "UK".
Department
string
The name of the department in which the user works.
Display name
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.
Email
string
The SMTP/email address for the user, for example, "jeff@contoso.onmicrosoft.com". Read-Only.
Given name
string
The given name (first name) of the user.
Job title
string
The user’s job title.
Nickname
string
The mail alias for the user. This property must be specified when a user is created.
Office location
string
The office location in the user's place of business.
Postal code
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
string
The user's surname (family name or last name).
Telephone number
string
The primary cellular telephone number for the user.
User Principal Name (UPN)
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.
User id
string
A unique identifier for the user object in the directory.

ClientPhotoMetadata

Photo Metadata class

ContentType
string
Content Type of photo
Has photo
boolean
Has photo
Height
integer
Height of photo
Image File Extension
string
File extension for the photo (ex: ".jpg")
Width
integer
Width of photo

GraphUser_V1

User from Graph API

About Me
string
About Me
Account enabled?
boolean
true if the account is enabled; otherwise, false. This property is required when a user is created.
Birthday
date-time
Birthday
Business Phones
array of string
Business Phones
City
string
The city in which the user is located.
Company name
string
The name of the company in which the user works.
Country
string
The country/region in which the user is located; for example, "US" or "UK".
Department
string
The name of the department in which the user works.
Display Name
string
Display Name
Given Name
string
Given Name
Hire Date
date-time
Hire Date
Id
string
Id
Interests
array of string
Interests
Job Title
string
Job Title
Mail
string
Mail
Mobile Phone
string
Mobile Phone
My Site
string
My Site
Nickname
string
The mail alias for the user. This property must be specified when a user is created.
Office Location
string
Office Location
Past Projects
array of string
Past Projects
Postal code
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
string
Preferred Language
Preferred Name
string
Preferred Name
Responsibilities
array of string
Responsibilities
Schools
array of string
Schools
Skills
array of string
Skills
State
string
State
Street Address
string
Street Address
Surname
string
Surname
User Principal Name
string
User Principal Name
User Type
string
User Type

GraphTrending

Trending documents from Graph API

Container display name
string
A string describing where the item is stored
Container type
string
Can be used for filtering by the type of container in which the file is stored
Container web URL
string
A path leading to the folder in which the item is stored
Id
string
Unique identifier of the relationship
Id
string
The item's unique identifier
Media type
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
string
A URL leading to the preview image for the item
Preview text
string
A preview text for the item
Title
string
The item's title text
Type
string
The item's media type (can be used for filtering for a specific file based on a specific type)
Type
string
A string value that can be used to classify the item, such as "microsoft.graph.driveItem"
Web URL
string
A URL leading to the referenced item
Weight
float
Value indicating how much the document is currently trending