# Microsoft 365 People

> 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.

App · 16 actions. Web page: https://docs.lodol.com/docs/integrations/microsoft-365-people

## Actions

### Add contact

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

**Inputs**

- First name (`given_name`, text, required): The contact's first name.
- Last name (`surname`, text): The contact's last name.
- Display name (`display_name`, text): The name Outlook shows. Leave empty to have Outlook make it from the first and last name.
- Email (`email`, text): The contact's email address.
- Second email (`second_email`, text): Another email address.
- Mobile phone (`mobile_phone`, text): The mobile number.
- Business phone (`business_phone`, text): A work number.
- Home phone (`home_phone`, text): A home number.
- Company (`company_name`, text): The company they work for.
- Job title (`job_title`, text): Their job title.
- Department (`department`, text): Their department.
- Office (`office_location`, text): Where their office is.
- Business street (`business_street`, text): Street of the work address.
- Business city (`business_city`, text): City of the work address.
- Business state (`business_state`, text): State or province of the work address.
- Business postal code (`business_postal_code`, text): Postal code of the work address.
- Business country (`business_country`, text): Country or region of the work address.
- Birthday (`birthday`, date): The contact's birthday.
- Notes (`notes`, text): Your notes about the contact.
- Categories (`categories`, list): Outlook category names to tag the contact with.
- Contact folder (`folder_id`, text): The folder to add it to. Leave empty for your main Contacts folder.

**Outputs**

- `contact` (object): An Outlook contact

**Example output**

```json
{
  "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 (`name`, text, required): The new folder's name.
- Inside folder (`parent_folder_id`, text): Put it inside this folder. Leave empty for the top level.

**Outputs**

- `folder` (object): A contact folder

**Example output**

```json
{
  "folder": {
    "displayName": "Suppliers",
    "id": "AAMkAGI2AAEOAAA=",
    "parentFolderId": "AAMkAGI2AAEMAAA="
  }
}
```

### Delete contact

Delete an Outlook contact. It goes to Deleted Items.

**Inputs**

- Contact (`contact_id`, text, required): The contact's id, from an earlier step such as Add contact, List contacts or the New contact trigger.

**Outputs**

- `contact_id` (text): The id of the contact deleted
- `deleted` (true/false): Always true once the contact is deleted

**Example output**

```json
{
  "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_id`, text, required): The contact folder. Pick one, or use its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once the folder is deleted
- `folder_id` (text): The id of the folder deleted

**Example output**

```json
{
  "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 (`search`, text): A name or email address to look for. Leave empty to list everyone.
- Maximum results (`limit`, number): How many to return at most, from 1 to 1000. From 1 to 1000. Default: `25`.

**Outputs**

- `count` (number): How many are returned
- `people` (list): The people, most relevant first

**Example output**

```json
{
  "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_id`, text, required): The contact's id, from an earlier step such as Add contact, List contacts or the New contact trigger.

**Outputs**

- `contact` (object): An Outlook contact

**Example output**

```json
{
  "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_id`, text, required): The contact folder. Pick one, or use its id from an earlier step.

**Outputs**

- `folder` (object): A contact folder

**Example output**

```json
{
  "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_manager` (true/false): Whether a manager is set
- `manager` (object): A person in your organization's directory

**Example output**

```json
{
  "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**

- `user` (object): A person in your organization's directory

**Example output**

```json
{
  "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 (`person`, text, required): The person in your organization. Pick one, or enter their id or work email address.

**Outputs**

- `user` (object): A person in your organization's directory

**Example output**

```json
{
  "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_id`, text): List the folders inside this one. Leave empty for your top-level folders.

**Outputs**

- `count` (number): How many are returned
- `folders` (list): The folders

**Example output**

```json
{
  "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_id`, text): The folder to list. Leave empty for your main Contacts folder.
- Email (`email`, text): Only contacts with this exact email address. Leave empty for all.
- Maximum results (`limit`, number): How many to return at most, from 1 to 1000. From 1 to 1000. Default: `25`.

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many are returned

**Example output**

```json
{
  "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 (`manager`, text): Whose direct reports to list. Leave empty for yours.
- Maximum results (`limit`, number): How many to return at most, from 1 to 1000. From 1 to 1000. Default: `1000`.

**Outputs**

- `count` (number): How many are returned
- `reports` (list): The direct reports

**Example output**

```json
{
  "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_id`, text, required): The contact folder. Pick one, or use its id from an earlier step.
- New name (`name`, text, required): The folder's new name.

**Outputs**

- `folder` (object): A contact folder

**Example output**

```json
{
  "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 (`search`, text): A name or email address to look for. Leave empty to list everyone.
- Maximum results (`limit`, number): How many to return at most, from 1 to 1000. From 1 to 1000. Default: `25`.

**Outputs**

- `count` (number): How many are returned
- `users` (list): The people found

**Example output**

```json
{
  "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_id`, text, required): The contact's id, from an earlier step such as Add contact, List contacts or the New contact trigger.
- First name (`given_name`, text): The contact's first name. Leave empty to keep it.
- Last name (`surname`, text): The contact's last name. Leave empty to keep it.
- Display name (`display_name`, text): The name Outlook shows. Leave empty to have Outlook make it from the first and last name. Otherwise it is kept.
- Email (`email`, text): The contact's email address. Replaces their first address; others are kept.
- Second email (`second_email`, text): Another email address. Replaces their second address; others are kept.
- Mobile phone (`mobile_phone`, text): The mobile number. Leave empty to keep it.
- Business phone (`business_phone`, text): A work number. Replaces their first work number; others are kept.
- Home phone (`home_phone`, text): A home number. Replaces their first home number; others are kept.
- Company (`company_name`, text): The company they work for. Leave empty to keep it.
- Job title (`job_title`, text): Their job title. Leave empty to keep it.
- Department (`department`, text): Their department. Leave empty to keep it.
- Office (`office_location`, text): Where their office is. Leave empty to keep it.
- Business street (`business_street`, text): Street of the work address. Leave empty to keep it.
- Business city (`business_city`, text): City of the work address. Leave empty to keep it.
- Business state (`business_state`, text): State or province of the work address. Leave empty to keep it.
- Business postal code (`business_postal_code`, text): Postal code of the work address. Leave empty to keep it.
- Business country (`business_country`, text): Country or region of the work address. Leave empty to keep it.
- Birthday (`birthday`, date): The contact's birthday. Leave empty to keep it.
- Notes (`notes`, text): Your notes about the contact. Replaces the old notes; leave empty to keep them.
- Categories (`categories`, list): Outlook category names to tag the contact with. Replaces all its categories; leave empty to keep them.

**Outputs**

- `contact` (object): An Outlook contact

**Example output**

```json
{
  "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"
  }
}
```
