IT Pro: How to read user's groups from Active Directory

Group membership information can be used to distribute different email signatures to user groups. This is helpful when your data source lacks sufficient or updated information to segment users through field data.

Create the Groups Field in Xink

  1. Go to Preferences > Fields and click the + button.
  2. Add the property name groupCnList.
Xink accounts created after February 2018 include the Groups field by default.

Add groupCnList field in Preferences

Read Groups from Entra ID (formerly Azure Active Directory)

Submit a support ticket to enable group membership sync from Azure AD.

Example group memberships output:

["Services", "TEAM FLY", "_Fleet_Monitor_Export", "Release_Manager", "IT-admins", "IT users", "TEAM EXCHANGE", "IT-IN", "Second_Line", "_Fleet_Monitor_Managers", "E3 - Full", "SMC Designers", "IT-IN Xware Test", "System_Owner", "Team Mobile", "Service_Now_Users", "Intune - E3 EMS license", "TEST - TH"]

Example of Azure AD groups output

Read Groups from On-Premises Active Directory

If your account was created before February 2018, download the latest version of the ADExport tool from your Xink portal.

ADExport tool interface

By default, the tool does not export group memberships. Add the /ug switch at the end of your command line to include them.

Examples

Export all Active Directory users and their group memberships:

C:\emsadexport.exe /secret:"INSERT-YOUR-SECRET-TOKEN" /ug

Export users from a specific Active Directory group:

C:\emsadexport.exe /secret:"INSERT-YOUR-SECRET-TOKEN" /group:"My Test" /remove+ /ug

To verify that group memberships are being exported correctly, check for the groupCnList value in user records.

Verify groupCnList output in records

Learn more from  Example #7 in this article.

If you receive [] as a result, it's likely due to the use of the /domain: switch, which is not compatible with /ug.

Create a Rule to Target Group Membership

To assign signatures based on group membership, go to Preferences > Rules. Create a rule that checks the Groups field:

Create rule for Groups field in Preferences

Best practice: Avoid adding extra conditions. Use one rule per group for easier maintenance.

Use the up/down rule order controls to define execution priority. The first matched rule will apply.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.
Quick 1-on-1 Demo | Ⓒ 2025 Xink