Configure and Use Custom Extension Attributes

This article explains how to configure custom extension attributes in Microsoft 365, verify them using Microsoft Graph Explorer, and use them within Crossware.

Add a Custom Attribute in Microsoft 365

1. Go to the Exchange admin center.

2. In the left navigation, select Users > Active users.

3. Select the user you want to update.

4. In the user details pane, select the Mail tab.

5. Choose Edit Exchange properties.

6. Select the Others tab.

7. Under Custom attributes, select an empty text box and enter the required value.

8. Select Save.

Verify the Attribute in Microsoft Graph Explorer

1. Open Graph Explorer.

2. Sign in by selecting the profile icon in the upper-right corner.

3. In the query box, enter the following request:

   https://graph.microsoft.com/v1.0/users/{user-email}?$select=displayName,onPremisesExtensionAttributes
   

   Replace {user-email} with the user’s actual email address.

   Example:

   https://graph.microsoft.com/v1.0/users/admin@crosswaredemo.com/?$select=displayName,onPremisesExtensionAttributes
   

4. Select Run query.

5. Confirm that the expected extension attributes are returned in the response.

Create a Directory Field in Crossware

1. Go to the Crossware Portal.

2. Select Fields.

3. Choose Create directory field.

4. Enter a name for the directory field.

5. In the value field, enter the attribute reference in the following format:

   onPremisesExtensionAttributes:{attributeName}
   

   Example:

   onPremisesExtensionAttributes:extensionAttribute1
   

6. Select Save & Close.

Test the Directory Field

1. Select the field you have created.

2. Select the Send Test Email icon.

3. Select Send.

4. Verify that the custom attribute values appear in the test email.