> For the complete documentation index, see [llms.txt](https://docs.popl.co/introduction/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.popl.co/introduction/integrations/syncing-members-from-azure-active-directory-entra-id/entra-id-azure-auto-sync-tm.md).

# Entra ID (Azure) - Auto Sync™

#### The Initial Sync

During the initial sync, Popl Teams will create digital business cards for each member with the attribute mappings listed below: 

| **Popl Field**  | **Azure Field**                                                             |
| --------------- | --------------------------------------------------------------------------- |
| Name            | Display Name                                                                |
| Email           | Email or (fallback: User principal name)                                    |
| Job Title       | Job title                                                                   |
| Company         | Company name                                                                |
| Phone Number    | Mobile phone (mobilePhone) with fallback as Business phone (businessPhone)  |
| Location        | Street address, City, State/Province, ZIP or postal code, Country or region |
| Profile Picture | Profile Picture                                                             |

If a member's email from the sync is already attached to a Popl digital business card, we will simply invite the existing member instead of creating them. The existing Popl user will get an email invite to join your company on Popl Teams unless you have "Send Email Invites" toggled off.

#### Future Syncs with Auto Sync™

As your company grows, names, titles, departments, and other member info can change. With any sync after your initial one, Auto Sync™ will automatically update Popl digital cards to correct, up-to-date info without any manual entry.

For example, let's say that Jessica Swift gets a promotion and her title changes from Marketing Manager to Director of Marketing. After a successful daily, weekly, monthly or quarterly auto sync, this title change will instantly reflect on Jessica's digital business card. Syncs can also be run manually by clicking the "Edit Setup" button at any time from the add members page or the integrations tab.

#### Enabling Auto Sync™

To enable an auto sync option, click on "Edit Setup", then under the group search bar, see section labeled **Auto Sync Frequency**. Next, pick the cadence you'd like, then click "Save Configuration" in the bottom right to save this setup. You can also click "Sync Now" to run a sync immediately if you'd like.

Use the **Overwrite** toggle options for each field to decide which fields you'd like to update on future syncs, even if those fields have values already. For example, if "Job Title" has a value that isn't the same as on the Active Directory side and the toggle for overwriting "Job Title" is toggled on, the next auto sync will **overwrite** this value with the value from the AD side.

<figure><img src="/files/eXyCHJK7PCISsXX3Y9vX" alt=""><figcaption><p>Use the "Sync" toggles for the initial sync, and the "Overwrite" toggles for future auto syncs</p></figcaption></figure>

If any issues or questions, please contact us at <teams@popl.co>, we are available nearly 24/7 and will get back to you within 6-8 hours or less.

\
With 🤍 from Popl.&#x20;


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.popl.co/introduction/integrations/syncing-members-from-azure-active-directory-entra-id/entra-id-azure-auto-sync-tm.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.