Microsoft 365 People
App · 16 actions
Find the people you work with, look people up in your organization's directory, and keep your Outlook contacts and contact folders up to date.
Actions
| Action | What it does |
|---|---|
| Add contact | Add a contact to your Outlook contacts, in your main Contacts folder or another. |
| Add contact folder | Add a folder to your Outlook contacts, at the top level or inside another. |
| Delete contact | Delete an Outlook contact. |
| Delete contact folder | Delete a contact folder and the contacts in it. |
| Find people | List the people you work with most, most relevant first, or find people by name or email. |
| Get contact | Get one of your Outlook contacts: names, emails, phones, work details, address, birthday and notes. |
| Get contact folder | Get a contact folder's name and the folder it is in. |
| Get my manager | Get your manager from the directory. |
| Get my profile | Get your own name, email, job title, phones and office from the directory. |
| Get person | Get someone in your organization: name, email, job title, phones and office. |
| List contact folders | List the folders in your Outlook contacts, or the folders inside one. |
| List contacts | List your Outlook contacts, in your main Contacts folder or another, or find the contacts with an email address. |
| List direct reports | List the people who report to you, or to someone else in your organization. |
| Rename contact folder | Give a contact folder a new name. |
| Search directory | Find people in your organization's directory by name or email address, or list everyone. |
| Update contact | Change an Outlook contact. |
Add contact
Add a contact to your Outlook contacts, in your main Contacts folder or another.
Inputs
- First name
given_nametextRequired - The contact's first name.
- Last name
surnametext - The contact's last name.
- Display name
display_nametext - The name Outlook shows. Leave empty to have Outlook make it from the first and last name.
- Email
emailtext - The contact's email address.
- Second email
second_emailtext - Another email address.
- Mobile phone
mobile_phonetext - The mobile number.
- Business phone
business_phonetext - A work number.
- Home phone
home_phonetext - A home number.
- Company
company_nametext - The company they work for.
- Job title
job_titletext - Their job title.
- Department
departmenttext - Their department.
- Office
office_locationtext - Where their office is.
- Business street
business_streettext - Street of the work address.
- Business city
business_citytext - City of the work address.
- Business state
business_statetext - State or province of the work address.
- Business postal code
business_postal_codetext - Postal code of the work address.
- Business country
business_countrytext - Country or region of the work address.
- Birthday
birthdaydate - The contact's birthday.
- Notes
notestext - Your notes about the contact.
- Categories
categorieslist - Outlook category names to tag the contact with.
- Contact folder
folder_idtext - The folder to add it to. Leave empty for your main Contacts folder.
Outputs
contactobject- An Outlook contact
Example output
{
"contact": {
"birthday": "1974-07-22",
"businessAddress": {
"city": "Redmond",
"countryOrRegion": "USA",
"postalCode": "98075",
"state": "WA",
"street": "10 Contoso Way"
},
"businessPhones": [
"+1 918 555 0101"
],
"categories": [],
"companyName": "Contoso, Inc.",
"createdDateTime": "2026-10-19T23:08:24Z",
"department": "Sales & Marketing",
"displayName": "Garth Fort",
"email": "garth@contoso.com",
"emailAddresses": [
{
"address": "garth@contoso.com",
"name": "Garth"
}
],
"givenName": "Garth",
"homePhones": [],
"id": "AAMkAGI2THk0AAA=",
"jobTitle": "Web Marketing Manager",
"lastModifiedDateTime": "2026-10-19T23:08:24Z",
"mobilePhone": "",
"officeLocation": "20/1101",
"parentFolderId": "AAMkAGI2AAEOAAA=",
"personalNotes": "",
"surname": "Fort"
}
}Add contact folder
Add a folder to your Outlook contacts, at the top level or inside another.
Inputs
- Name
nametextRequired - The new folder's name.
- Inside folder
parent_folder_idtext - Put it inside this folder. Leave empty for the top level.
Outputs
folderobject- A contact folder
Example output
{
"folder": {
"displayName": "Suppliers",
"id": "AAMkAGI2AAEOAAA=",
"parentFolderId": "AAMkAGI2AAEMAAA="
}
}Delete contact
Delete an Outlook contact. It goes to Deleted Items.
Inputs
- Contact
contact_idtextRequired - The contact's id, from an earlier step such as Add contact, List contacts or the New contact trigger.
Outputs
contact_idtext- The id of the contact deleted
deletedtrue/false- Always true once the contact is deleted
Example output
{
"contact_id": "AAMkAGI2THk0AAA=",
"deleted": true
}Delete contact folder
Delete a contact folder and the contacts in it. It goes to Deleted Items.
Inputs
- Contact folder
folder_idtextRequired - The contact folder. Pick one, or use its id from an earlier step.
Outputs
deletedtrue/false- Always true once the folder is deleted
folder_idtext- The id of the folder deleted
Example output
{
"deleted": true,
"folder_id": "AAMkAGI2AAEOAAA="
}Find people
List the people you work with most, most relevant first, or find people by name or email. Covers colleagues, contacts and people you email.
Inputs
- Search
searchtext - A name or email address to look for. Leave empty to list everyone.
- Maximum results
limitnumber - How many to return at most, from 1 to 1000.From 1 to 1000. Default:
25.
Outputs
countnumber- How many are returned
peoplelist- The people, most relevant first
Example output
{
"count": 1,
"people": [
{
"companyName": "",
"department": "Sales & Marketing",
"displayName": "Isaiah Langer",
"email": "IsaiahL@contoso.com",
"givenName": "Isaiah",
"id": "e3d0513b-449e-4198-ba6f-bd97ae7cae85",
"jobTitle": "Web Marketing Manager",
"officeLocation": "20/1101",
"personClass": "Person",
"personSubclass": "OrganizationUser",
"phones": [
{
"number": "+1 918 555 0101",
"type": "business"
}
],
"scoredEmailAddresses": [
{
"address": "IsaiahL@contoso.com",
"relevanceScore": 20.0
}
],
"surname": "Langer",
"userPrincipalName": "IsaiahL@contoso.com"
}
]
}Get contact
Get one of your Outlook contacts: names, emails, phones, work details, address, birthday and notes.
Inputs
- Contact
contact_idtextRequired - The contact's id, from an earlier step such as Add contact, List contacts or the New contact trigger.
Outputs
contactobject- An Outlook contact
Example output
{
"contact": {
"birthday": "1974-07-22",
"businessAddress": {
"city": "Redmond",
"countryOrRegion": "USA",
"postalCode": "98075",
"state": "WA",
"street": "10 Contoso Way"
},
"businessPhones": [
"+1 918 555 0101"
],
"categories": [],
"companyName": "Contoso, Inc.",
"createdDateTime": "2026-10-19T23:08:24Z",
"department": "Sales & Marketing",
"displayName": "Garth Fort",
"email": "garth@contoso.com",
"emailAddresses": [
{
"address": "garth@contoso.com",
"name": "Garth"
}
],
"givenName": "Garth",
"homePhones": [],
"id": "AAMkAGI2THk0AAA=",
"jobTitle": "Web Marketing Manager",
"lastModifiedDateTime": "2026-10-19T23:08:24Z",
"mobilePhone": "",
"officeLocation": "20/1101",
"parentFolderId": "AAMkAGI2AAEOAAA=",
"personalNotes": "",
"surname": "Fort"
}
}Get contact folder
Get a contact folder's name and the folder it is in.
Inputs
- Contact folder
folder_idtextRequired - The contact folder. Pick one, or use its id from an earlier step.
Outputs
folderobject- A contact folder
Example output
{
"folder": {
"displayName": "Suppliers",
"id": "AAMkAGI2AAEOAAA=",
"parentFolderId": "AAMkAGI2AAEMAAA="
}
}Get my manager
Get your manager from the directory. has_manager is false when none is set.
Inputs
None.
Outputs
has_managertrue/false- Whether a manager is set
managerobject- A person in your organization's directory
Example output
{
"has_manager": true,
"manager": {
"businessPhones": [
"+1 425 555 0109"
],
"displayName": "Adele Vance",
"givenName": "Adele",
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"jobTitle": "Retail Manager",
"mail": "AdeleV@contoso.com",
"mobilePhone": "+1 425 555 0109",
"officeLocation": "18/2111",
"preferredLanguage": "en-US",
"surname": "Vance",
"type": "user",
"userPrincipalName": "AdeleV@contoso.com"
}
}Get my profile
Get your own name, email, job title, phones and office from the directory.
Inputs
None.
Outputs
userobject- A person in your organization's directory
Example output
{
"user": {
"businessPhones": [
"+1 425 555 0109"
],
"displayName": "Adele Vance",
"givenName": "Adele",
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"jobTitle": "Retail Manager",
"mail": "AdeleV@contoso.com",
"mobilePhone": "+1 425 555 0109",
"officeLocation": "18/2111",
"preferredLanguage": "en-US",
"surname": "Vance",
"type": "user",
"userPrincipalName": "AdeleV@contoso.com"
}
}Get person
Get someone in your organization: name, email, job title, phones and office.
Inputs
- Person
persontextRequired - The person in your organization. Pick one, or enter their id or work email address.
Outputs
userobject- A person in your organization's directory
Example output
{
"user": {
"businessPhones": [
"+1 425 555 0109"
],
"displayName": "Adele Vance",
"givenName": "Adele",
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"jobTitle": "Retail Manager",
"mail": "AdeleV@contoso.com",
"mobilePhone": "+1 425 555 0109",
"officeLocation": "18/2111",
"preferredLanguage": "en-US",
"surname": "Vance",
"type": "user",
"userPrincipalName": "AdeleV@contoso.com"
}
}List contact folders
List the folders in your Outlook contacts, or the folders inside one.
Inputs
- Inside folder
parent_folder_idtext - List the folders inside this one. Leave empty for your top-level folders.
Outputs
countnumber- How many are returned
folderslist- The folders
Example output
{
"count": 1,
"folders": [
{
"displayName": "Suppliers",
"id": "AAMkAGI2AAEOAAA=",
"parentFolderId": "AAMkAGI2AAEMAAA="
}
]
}List contacts
List your Outlook contacts, in your main Contacts folder or another, or find the contacts with an email address.
Inputs
- Contact folder
folder_idtext - The folder to list. Leave empty for your main Contacts folder.
- Email
emailtext - Only contacts with this exact email address. Leave empty for all.
- Maximum results
limitnumber - How many to return at most, from 1 to 1000.From 1 to 1000. Default:
25.
Outputs
contactslist- The contacts
countnumber- How many are returned
Example output
{
"contacts": [
{
"birthday": "1974-07-22",
"businessAddress": {
"city": "Redmond",
"countryOrRegion": "USA",
"postalCode": "98075",
"state": "WA",
"street": "10 Contoso Way"
},
"businessPhones": [
"+1 918 555 0101"
],
"categories": [],
"companyName": "Contoso, Inc.",
"createdDateTime": "2026-10-19T23:08:24Z",
"department": "Sales & Marketing",
"displayName": "Garth Fort",
"email": "garth@contoso.com",
"emailAddresses": [
{
"address": "garth@contoso.com",
"name": "Garth"
}
],
"givenName": "Garth",
"homePhones": [],
"id": "AAMkAGI2THk0AAA=",
"jobTitle": "Web Marketing Manager",
"lastModifiedDateTime": "2026-10-19T23:08:24Z",
"mobilePhone": "",
"officeLocation": "20/1101",
"parentFolderId": "AAMkAGI2AAEOAAA=",
"personalNotes": "",
"surname": "Fort"
}
],
"count": 1
}List direct reports
List the people who report to you, or to someone else in your organization.
Inputs
- Manager
managertext - Whose direct reports to list. Leave empty for yours.
- Maximum results
limitnumber - How many to return at most, from 1 to 1000.From 1 to 1000. Default:
1000.
Outputs
countnumber- How many are returned
reportslist- The direct reports
Example output
{
"count": 1,
"reports": [
{
"businessPhones": [
"+1 425 555 0109"
],
"displayName": "Adele Vance",
"givenName": "Adele",
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"jobTitle": "Retail Manager",
"mail": "AdeleV@contoso.com",
"mobilePhone": "+1 425 555 0109",
"officeLocation": "18/2111",
"preferredLanguage": "en-US",
"surname": "Vance",
"type": "user",
"userPrincipalName": "AdeleV@contoso.com"
}
]
}Rename contact folder
Give a contact folder a new name.
Inputs
- Contact folder
folder_idtextRequired - The contact folder. Pick one, or use its id from an earlier step.
- New name
nametextRequired - The folder's new name.
Outputs
folderobject- A contact folder
Example output
{
"folder": {
"displayName": "Suppliers",
"id": "AAMkAGI2AAEOAAA=",
"parentFolderId": "AAMkAGI2AAEMAAA="
}
}Search directory
Find people in your organization's directory by name or email address, or list everyone.
Inputs
- Search
searchtext - A name or email address to look for. Leave empty to list everyone.
- Maximum results
limitnumber - How many to return at most, from 1 to 1000.From 1 to 1000. Default:
25.
Outputs
countnumber- How many are returned
userslist- The people found
Example output
{
"count": 1,
"users": [
{
"businessPhones": [
"+1 425 555 0109"
],
"displayName": "Adele Vance",
"givenName": "Adele",
"id": "87d349ed-44d7-43e1-9a83-5f2406dee5bd",
"jobTitle": "Retail Manager",
"mail": "AdeleV@contoso.com",
"mobilePhone": "+1 425 555 0109",
"officeLocation": "18/2111",
"preferredLanguage": "en-US",
"surname": "Vance",
"type": "user",
"userPrincipalName": "AdeleV@contoso.com"
}
]
}Update contact
Change an Outlook contact. Only the fields you fill in change; everything else, including their other emails and phone numbers, stays as it is.
Inputs
- Contact
contact_idtextRequired - The contact's id, from an earlier step such as Add contact, List contacts or the New contact trigger.
- First name
given_nametext - The contact's first name. Leave empty to keep it.
- Last name
surnametext - The contact's last name. Leave empty to keep it.
- Display name
display_nametext - The name Outlook shows. Leave empty to have Outlook make it from the first and last name. Otherwise it is kept.
- Email
emailtext - The contact's email address. Replaces their first address; others are kept.
- Second email
second_emailtext - Another email address. Replaces their second address; others are kept.
- Mobile phone
mobile_phonetext - The mobile number. Leave empty to keep it.
- Business phone
business_phonetext - A work number. Replaces their first work number; others are kept.
- Home phone
home_phonetext - A home number. Replaces their first home number; others are kept.
- Company
company_nametext - The company they work for. Leave empty to keep it.
- Job title
job_titletext - Their job title. Leave empty to keep it.
- Department
departmenttext - Their department. Leave empty to keep it.
- Office
office_locationtext - Where their office is. Leave empty to keep it.
- Business street
business_streettext - Street of the work address. Leave empty to keep it.
- Business city
business_citytext - City of the work address. Leave empty to keep it.
- Business state
business_statetext - State or province of the work address. Leave empty to keep it.
- Business postal code
business_postal_codetext - Postal code of the work address. Leave empty to keep it.
- Business country
business_countrytext - Country or region of the work address. Leave empty to keep it.
- Birthday
birthdaydate - The contact's birthday. Leave empty to keep it.
- Notes
notestext - Your notes about the contact. Replaces the old notes; leave empty to keep them.
- Categories
categorieslist - Outlook category names to tag the contact with. Replaces all its categories; leave empty to keep them.
Outputs
contactobject- An Outlook contact
Example output
{
"contact": {
"birthday": "1974-07-22",
"businessAddress": {
"city": "Redmond",
"countryOrRegion": "USA",
"postalCode": "98075",
"state": "WA",
"street": "10 Contoso Way"
},
"businessPhones": [
"+1 918 555 0101"
],
"categories": [],
"companyName": "Contoso, Inc.",
"createdDateTime": "2026-10-19T23:08:24Z",
"department": "Sales & Marketing",
"displayName": "Garth Fort",
"email": "garth@contoso.com",
"emailAddresses": [
{
"address": "garth@contoso.com",
"name": "Garth"
}
],
"givenName": "Garth",
"homePhones": [],
"id": "AAMkAGI2THk0AAA=",
"jobTitle": "Web Marketing Manager",
"lastModifiedDateTime": "2026-10-19T23:08:24Z",
"mobilePhone": "",
"officeLocation": "20/1101",
"parentFolderId": "AAMkAGI2AAEOAAA=",
"personalNotes": "",
"surname": "Fort"
}
}