Azure AD

Manage users and groups in Azure AD (Microsoft Entra ID)

Azure Active Directory (now Microsoft Entra ID) is Microsoft's cloud-based identity and access management service. It helps organizations manage users, groups, and access to applications and resources across cloud and on-premises environments.

With the Azure AD integration in Sim, you can:

  • Manage users: List, create, update, and delete user accounts in your directory
  • Manage groups: Create and configure security groups and Microsoft 365 groups
  • Control group membership: Add and remove members from groups programmatically
  • Query directory data: Search and filter users and groups using OData expressions
  • Automate onboarding/offboarding: Create new user accounts with initial passwords and enable/disable accounts as part of HR workflows

In Sim, the Azure AD integration enables your agents to programmatically manage your organization's identity infrastructure. This allows for automation scenarios such as provisioning new employees, updating user profiles in bulk, managing team group memberships, and auditing directory data. By connecting Sim with Azure AD, you can streamline identity lifecycle management and ensure your directory stays in sync with your organization's needs.

Need Help?

If you encounter issues with the Azure AD integration, contact us at help@sim.ai

Usage Instructions

Integrate Azure Active Directory into your workflows. List, create, update, and delete users and groups. Manage group memberships programmatically.

Tools

microsoft_ad_list_users

List users in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
topnumberNoMaximum number of users to return (default 100, max 999)
filterstringNoOData filter expression (e.g., "department eq 'Sales'")
searchstringNoSearch string to filter users by displayName or mail

Output

ParameterTypeDescription
usersarrayList of users
userCountnumberNumber of users returned

microsoft_ad_get_user

Get a user by ID or user principal name from Azure AD

Input

ParameterTypeRequiredDescription
userIdstringYesUser ID or user principal name (e.g., "user@example.com")

Output

ParameterTypeDescription
userobjectUser details
idstringUser ID
displayNamestringDisplay name
givenNamestringFirst name
surnamestringLast name
userPrincipalNamestringUser principal name (email)
mailstringEmail address
jobTitlestringJob title
departmentstringDepartment
officeLocationstringOffice location
mobilePhonestringMobile phone number
accountEnabledbooleanWhether the account is enabled

microsoft_ad_create_user

Create a new user in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
displayNamestringYesDisplay name for the user
mailNicknamestringYesMail alias for the user
userPrincipalNamestringYesUser principal name (e.g., "user@example.com")
passwordstringYesInitial password for the user
accountEnabledbooleanYesWhether the account is enabled
givenNamestringNoFirst name
surnamestringNoLast name
jobTitlestringNoJob title
departmentstringNoDepartment
officeLocationstringNoOffice location
mobilePhonestringNoMobile phone number

Output

ParameterTypeDescription
userobjectCreated user details
idstringUser ID
displayNamestringDisplay name
givenNamestringFirst name
surnamestringLast name
userPrincipalNamestringUser principal name (email)
mailstringEmail address
jobTitlestringJob title
departmentstringDepartment
officeLocationstringOffice location
mobilePhonestringMobile phone number
accountEnabledbooleanWhether the account is enabled

microsoft_ad_update_user

Update user properties in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
userIdstringYesUser ID or user principal name
displayNamestringNoDisplay name
givenNamestringNoFirst name
surnamestringNoLast name
jobTitlestringNoJob title
departmentstringNoDepartment
officeLocationstringNoOffice location
mobilePhonestringNoMobile phone number
accountEnabledbooleanNoWhether the account is enabled

Output

ParameterTypeDescription
updatedbooleanWhether the update was successful
userIdstringID of the updated user

microsoft_ad_delete_user

Delete a user from Azure AD (Microsoft Entra ID). The user is moved to a temporary container and can be restored within 30 days.

Input

ParameterTypeRequiredDescription
userIdstringYesUser ID or user principal name

Output

ParameterTypeDescription
deletedbooleanWhether the deletion was successful
userIdstringID of the deleted user

microsoft_ad_list_groups

List groups in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
topnumberNoMaximum number of groups to return (default 100, max 999)
filterstringNoOData filter expression (e.g., "securityEnabled eq true")
searchstringNoSearch string to filter groups by displayName or description

Output

ParameterTypeDescription
groupsarrayList of groups
groupCountnumberNumber of groups returned

microsoft_ad_get_group

Get a group by ID from Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
groupIdstringYesGroup ID

Output

ParameterTypeDescription
groupobjectGroup details
idstringGroup ID
displayNamestringDisplay name
descriptionstringGroup description
mailstringEmail address
mailEnabledbooleanWhether mail is enabled
mailNicknamestringMail nickname
securityEnabledbooleanWhether security is enabled
groupTypesarrayGroup types
visibilitystringGroup visibility
createdDateTimestringCreation date

microsoft_ad_create_group

Create a new group in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
displayNamestringYesDisplay name for the group
mailNicknamestringYesMail alias for the group (ASCII only, max 64 characters)
descriptionstringNoGroup description
mailEnabledbooleanYesWhether mail is enabled (true for Microsoft 365 groups)
securityEnabledbooleanYesWhether security is enabled (true for security groups)
groupTypesstringNoGroup type: "Unified" for Microsoft 365 group, leave empty for security group
visibilitystringNoGroup visibility: "Private" or "Public"

Output

ParameterTypeDescription
groupobjectCreated group details
idstringGroup ID
displayNamestringDisplay name
descriptionstringGroup description
mailstringEmail address
mailEnabledbooleanWhether mail is enabled
mailNicknamestringMail nickname
securityEnabledbooleanWhether security is enabled
groupTypesarrayGroup types
visibilitystringGroup visibility
createdDateTimestringCreation date

microsoft_ad_update_group

Update group properties in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
groupIdstringYesGroup ID
displayNamestringNoDisplay name
descriptionstringNoGroup description
mailNicknamestringNoMail alias
visibilitystringNoGroup visibility: "Private" or "Public"

Output

ParameterTypeDescription
updatedbooleanWhether the update was successful
groupIdstringID of the updated group

microsoft_ad_delete_group

Delete a group from Azure AD (Microsoft Entra ID). Microsoft 365 and security groups can be restored within 30 days.

Input

ParameterTypeRequiredDescription
groupIdstringYesGroup ID

Output

ParameterTypeDescription
deletedbooleanWhether the deletion was successful
groupIdstringID of the deleted group

microsoft_ad_list_group_members

List members of a group in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
groupIdstringYesGroup ID
topnumberNoMaximum number of members to return (default 100, max 999)

Output

ParameterTypeDescription
membersarrayList of group members
memberCountnumberNumber of members returned

microsoft_ad_add_group_member

Add a member to a group in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
groupIdstringYesGroup ID
memberIdstringYesUser ID of the member to add

Output

ParameterTypeDescription
addedbooleanWhether the member was added successfully
groupIdstringGroup ID
memberIdstringMember ID that was added

microsoft_ad_remove_group_member

Remove a member from a group in Azure AD (Microsoft Entra ID)

Input

ParameterTypeRequiredDescription
groupIdstringYesGroup ID
memberIdstringYesUser ID of the member to remove

Output

ParameterTypeDescription
removedbooleanWhether the member was removed successfully
groupIdstringGroup ID
memberIdstringMember ID that was removed

On this page

Start building today
Trusted by over 100,000 builders.
The open-source platform to build AI agents and run your agentic workforce.
Get started