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

ActionWhat it does
Add contactAdd a contact to your Outlook contacts, in your main Contacts folder or another.
Add contact folderAdd a folder to your Outlook contacts, at the top level or inside another.
Delete contactDelete an Outlook contact.
Delete contact folderDelete a contact folder and the contacts in it.
Find peopleList the people you work with most, most relevant first, or find people by name or email.
Get contactGet one of your Outlook contacts: names, emails, phones, work details, address, birthday and notes.
Get contact folderGet a contact folder's name and the folder it is in.
Get my managerGet your manager from the directory.
Get my profileGet your own name, email, job title, phones and office from the directory.
Get personGet someone in your organization: name, email, job title, phones and office.
List contact foldersList the folders in your Outlook contacts, or the folders inside one.
List contactsList your Outlook contacts, in your main Contacts folder or another, or find the contacts with an email address.
List direct reportsList the people who report to you, or to someone else in your organization.
Rename contact folderGive a contact folder a new name.
Search directoryFind people in your organization's directory by name or email address, or list everyone.
Update contactChange an Outlook contact.

Add contact

Add a contact to your Outlook contacts, in your main Contacts folder or another.

Inputs

First namegiven_nametextRequired
The contact's first name.
Last namesurnametext
The contact's last name.
Display namedisplay_nametext
The name Outlook shows. Leave empty to have Outlook make it from the first and last name.
Emailemailtext
The contact's email address.
Second emailsecond_emailtext
Another email address.
Mobile phonemobile_phonetext
The mobile number.
Business phonebusiness_phonetext
A work number.
Home phonehome_phonetext
A home number.
Companycompany_nametext
The company they work for.
Job titlejob_titletext
Their job title.
Departmentdepartmenttext
Their department.
Officeoffice_locationtext
Where their office is.
Business streetbusiness_streettext
Street of the work address.
Business citybusiness_citytext
City of the work address.
Business statebusiness_statetext
State or province of the work address.
Business postal codebusiness_postal_codetext
Postal code of the work address.
Business countrybusiness_countrytext
Country or region of the work address.
Birthdaybirthdaydate
The contact's birthday.
Notesnotestext
Your notes about the contact.
Categoriescategorieslist
Outlook category names to tag the contact with.
Contact folderfolder_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

NamenametextRequired
The new folder's name.
Inside folderparent_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

Contactcontact_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 folderfolder_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

Searchsearchtext
A name or email address to look for. Leave empty to list everyone.
Maximum resultslimitnumber
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

Contactcontact_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 folderfolder_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

PersonpersontextRequired
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 folderparent_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 folderfolder_idtext
The folder to list. Leave empty for your main Contacts folder.
Emailemailtext
Only contacts with this exact email address. Leave empty for all.
Maximum resultslimitnumber
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

Managermanagertext
Whose direct reports to list. Leave empty for yours.
Maximum resultslimitnumber
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 folderfolder_idtextRequired
The contact folder. Pick one, or use its id from an earlier step.
New namenametextRequired
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

Searchsearchtext
A name or email address to look for. Leave empty to list everyone.
Maximum resultslimitnumber
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

Contactcontact_idtextRequired
The contact's id, from an earlier step such as Add contact, List contacts or the New contact trigger.
First namegiven_nametext
The contact's first name. Leave empty to keep it.
Last namesurnametext
The contact's last name. Leave empty to keep it.
Display namedisplay_nametext
The name Outlook shows. Leave empty to have Outlook make it from the first and last name. Otherwise it is kept.
Emailemailtext
The contact's email address. Replaces their first address; others are kept.
Second emailsecond_emailtext
Another email address. Replaces their second address; others are kept.
Mobile phonemobile_phonetext
The mobile number. Leave empty to keep it.
Business phonebusiness_phonetext
A work number. Replaces their first work number; others are kept.
Home phonehome_phonetext
A home number. Replaces their first home number; others are kept.
Companycompany_nametext
The company they work for. Leave empty to keep it.
Job titlejob_titletext
Their job title. Leave empty to keep it.
Departmentdepartmenttext
Their department. Leave empty to keep it.
Officeoffice_locationtext
Where their office is. Leave empty to keep it.
Business streetbusiness_streettext
Street of the work address. Leave empty to keep it.
Business citybusiness_citytext
City of the work address. Leave empty to keep it.
Business statebusiness_statetext
State or province of the work address. Leave empty to keep it.
Business postal codebusiness_postal_codetext
Postal code of the work address. Leave empty to keep it.
Business countrybusiness_countrytext
Country or region of the work address. Leave empty to keep it.
Birthdaybirthdaydate
The contact's birthday. Leave empty to keep it.
Notesnotestext
Your notes about the contact. Replaces the old notes; leave empty to keep them.
Categoriescategorieslist
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"
  }
}

On this page