> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Outlook Contacts

> Save Wave contacts to Microsoft Outlook, including photos

<Info>
  Available on the **Pro**, **Teams**, and **Enterprise** plans.
</Info>

The Outlook Contacts integration syncs Wave contacts into Microsoft Outlook / Microsoft 365 Contacts, including contact photos. It supports two modes: **individual** (your personal Outlook account) and **organization** (an admin connection that deploys synced contacts to every team member's Outlook automatically).

## How to Connect

### Individual (personal Outlook)

<Steps>
  <Step title="Open the integration">
    Go to **Integrations → Outlook Contacts**.
  </Step>

  <Step title="Enable auto-sync (optional)">
    Turn on **Auto-sync** to import all existing Wave contacts immediately.
  </Step>

  <Step title="Connect Outlook">
    Click **Connect** and sign in with your Microsoft account.
  </Step>
</Steps>

### Organization (all team members' Outlook)

<Steps>
  <Step title="Open the integration as an admin">
    An admin goes to **Integrations → Outlook Contacts**.
  </Step>

  <Step title="Connect with organization">
    Click **Connect with organization** and sign in with an Azure AD admin account.
  </Step>

  <Step title="Grant admin consent">
    Grant admin consent so Wave can sync contacts into every team member's Outlook.
  </Step>
</Steps>

Wave requests offline access (to keep the connection active) and read/write access to create and update contacts in Outlook.

## What Gets Synced

| Wave field                                | Outlook field                |
| ----------------------------------------- | ---------------------------- |
| First name                                | `givenName`                  |
| Last name                                 | `surname`                    |
| Display name                              | `displayName`                |
| Job title                                 | `jobTitle`                   |
| Company                                   | `companyName`                |
| Primary phone (mobile)                    | `mobilePhone`                |
| Work phone(s)                             | `businessPhones`             |
| Other phones                              | `homePhones`                 |
| Up to 3 emails                            | `emailAddresses`             |
| Street, city, state, postal code, country | `businessAddress`            |
| Website                                   | `businessHomePage`           |
| Contact note                              | `personalNotes`              |
| Contact photo                             | Outlook contact photo (JPEG) |

**Sync direction**: Wave → Outlook (outbound only)

**When it syncs**: Real-time on contact create, update, or delete

## Features

* **Organization mode**: a single admin connection syncs contacts into every eligible team member's Outlook (users whose email exists in the connected Azure AD tenant).
* **Contact photos**: profile photos are synced and converted to JPEG for Outlook compatibility.
* **Auto-sync on connect**: import all existing contacts on first connection using the Microsoft Graph batch API.
* **Deduplication**: contacts are identified by a Wave-specific extended property, so updates never create duplicates.

## Limitations & Requirements

* Outlook limits contacts to 3 email addresses. The primary email is always listed first.
* In organization mode, only users whose email exists in the connected Azure AD tenant receive synced contacts.
* Organization mode requires Azure AD admin consent.

## Disconnecting

Go to **Integrations → Outlook Contacts** and click **Disconnect**. This removes the integration. Contacts already synced to Outlook are not deleted.