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.

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 query
string
Fields to select

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 query
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 query
string
Fields to select

Returns

Body
GraphUser_V1

User from Graph API

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

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 query
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)

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
Birthday
date-time
Birthday
Business Phones
array of string
Business Phones
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
Office Location
string
Office Location
Past Projects
array of string
Past Projects
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

Limits

NameCallsRenewal Period
API calls per connection10060 seconds