Skip to main content

Microsoft Entra ID (Azure Active Directory Integration)

Written by Ben Feldman
Updated over 4 months ago

Integrating with Microsoft allows a full data transfer and removes any manual error since the data is synced automatically once a day from Shapes.

1. In the Microsoft Entra admin center, go to "App registrations"

2. In the "App registrations" tab, create a "New registration"

3. Fill out the name, leave the rest as default and click "Register"

4. Make a note of your Application (client) ID and Directory (tenant) ID - you will need these later when integrating from the Shapes side

5. Go to the "Certificates & Secrets" tab

6. Click on "New client secret"

7. Fill out the description and expiration (note the expiration will need to be replaced manually). Click "Add" and make a note of your secret value (also required when integrating from the Shapes side)

8. Under the "API permissions" tab, click on "Add a permission"

9. Click on "Application permissions"

10. Check the boxes called User.Read.All, User.ReadWrite.All and User-Phone.ReadWrite.All, and click on "Add permissions"

11. Repeat the process for Directory.Read.All and Directory.ReadWrite.All

12. In the configured permissions, click "Grant admin consent for Shapes"

13. The status is now changed to granted and you have the permissions!

All Super Admins can integrate data from Shapes with Microsoft Azure.

1. Enter Shapes' account settings -> Integrations -> Microsoft

2. Click on the "Connect" button

3. Fill out the Directory (tenant) ID, Application (client) ID and Secret Value, and click "Connect"

What data from Shapes is automatically synced to EntraID?

Shapes Field name

EntraID Field name
​

Email address
​

userPrincipalName, mailNickname
​

First name

givenName

Last name

surname

Job

jobTitle

Phone number

mobilePhone

Team

Department

Reports to

manager

First name +last name

displayname

Office
​

Office

You can contact support@shapes.co to choose which fields you'd like to sync and/or enable any additional filters. If you have any questions, feel free to reach out.

Did this answer your question?