Azure AD

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`

Input

Parameter	Type	Required	Description
`top`	number	No	No description
`filter`	string	No	OData filter expression (e.g., "department eq 'Sales'")
`search`	string	No	No description

Output

Parameter	Type	Description
`users`	array	List of users
`userCount`	number	Number of users returned

`microsoft_ad_get_user`

Input

Parameter	Type	Required	Description
`userId`	string	Yes	User ID or user principal name (e.g., "user@example.com")

Output

Parameter	Type	Description
`user`	object	User details
↳ `id`	string	User ID
↳ `displayName`	string	Display name
↳ `givenName`	string	First name
↳ `surname`	string	Last name
↳ `userPrincipalName`	string	User principal name (email)
↳ `mail`	string	Email address
↳ `jobTitle`	string	Job title
↳ `department`	string	Department
↳ `officeLocation`	string	Office location
↳ `mobilePhone`	string	Mobile phone number
↳ `accountEnabled`	boolean	Whether the account is enabled

`microsoft_ad_create_user`

Input

Parameter	Type	Required	Description
`displayName`	string	Yes	No description
`mailNickname`	string	Yes	No description
`userPrincipalName`	string	Yes	User principal name (e.g., "user@example.com")
`password`	string	Yes	No description
`accountEnabled`	boolean	Yes	No description
`givenName`	string	No	No description
`surname`	string	No	No description
`jobTitle`	string	No	No description
`department`	string	No	No description
`officeLocation`	string	No	No description
`mobilePhone`	string	No	No description

Output

Parameter	Type	Description
`user`	object	Created user details
↳ `id`	string	User ID
↳ `displayName`	string	Display name
↳ `givenName`	string	First name
↳ `surname`	string	Last name
↳ `userPrincipalName`	string	User principal name (email)
↳ `mail`	string	Email address
↳ `jobTitle`	string	Job title
↳ `department`	string	Department
↳ `officeLocation`	string	Office location
↳ `mobilePhone`	string	Mobile phone number
↳ `accountEnabled`	boolean	Whether the account is enabled

`microsoft_ad_update_user`

Input

Parameter	Type	Required	Description
`userId`	string	Yes	No description
`displayName`	string	No	No description
`givenName`	string	No	No description
`surname`	string	No	No description
`jobTitle`	string	No	No description
`department`	string	No	No description
`officeLocation`	string	No	No description
`mobilePhone`	string	No	No description
`accountEnabled`	boolean	No	No description

Output

Parameter	Type	Description
`updated`	boolean	Whether the update was successful
`userId`	string	ID 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

Parameter	Type	Required	Description
`userId`	string	Yes	No description

Output

Parameter	Type	Description
`deleted`	boolean	Whether the deletion was successful
`userId`	string	ID of the deleted user

`microsoft_ad_list_groups`

Input

Parameter	Type	Required	Description
`top`	number	No	No description
`filter`	string	No	OData filter expression (e.g., "securityEnabled eq true")
`search`	string	No	No description

Output

Parameter	Type	Description
`groups`	array	List of groups
`groupCount`	number	Number of groups returned

`microsoft_ad_get_group`

Input

Parameter	Type	Required	Description
`groupId`	string	Yes	No description

Output

Parameter	Type	Description
`group`	object	Group details
↳ `id`	string	Group ID
↳ `displayName`	string	Display name
↳ `description`	string	Group description
↳ `mail`	string	Email address
↳ `mailEnabled`	boolean	Whether mail is enabled
↳ `mailNickname`	string	Mail nickname
↳ `securityEnabled`	boolean	Whether security is enabled
↳ `groupTypes`	array	Group types
↳ `visibility`	string	Group visibility
↳ `createdDateTime`	string	Creation date

`microsoft_ad_create_group`

Input

Parameter	Type	Required	Description
`displayName`	string	Yes	No description
`mailNickname`	string	Yes	No description
`description`	string	No	No description
`mailEnabled`	boolean	Yes	No description
`securityEnabled`	boolean	Yes	No description
`groupTypes`	string	No	Group type: "Unified" for Microsoft 365 group, leave empty for security group
`visibility`	string	No	Group visibility: "Private" or "Public"

Output

Parameter	Type	Description
`group`	object	Created group details
↳ `id`	string	Group ID
↳ `displayName`	string	Display name
↳ `description`	string	Group description
↳ `mail`	string	Email address
↳ `mailEnabled`	boolean	Whether mail is enabled
↳ `mailNickname`	string	Mail nickname
↳ `securityEnabled`	boolean	Whether security is enabled
↳ `groupTypes`	array	Group types
↳ `visibility`	string	Group visibility
↳ `createdDateTime`	string	Creation date

`microsoft_ad_update_group`

Input

Parameter	Type	Required	Description
`groupId`	string	Yes	No description
`displayName`	string	No	No description
`description`	string	No	No description
`mailNickname`	string	No	No description
`visibility`	string	No	Group visibility: "Private" or "Public"

Output

Parameter	Type	Description
`updated`	boolean	Whether the update was successful
`groupId`	string	ID 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

Parameter	Type	Required	Description
`groupId`	string	Yes	No description

Output

Parameter	Type	Description
`deleted`	boolean	Whether the deletion was successful
`groupId`	string	ID of the deleted group

`microsoft_ad_list_group_members`

Input

Parameter	Type	Required	Description
`groupId`	string	Yes	No description
`top`	number	No	No description

Output

Parameter	Type	Description
`members`	array	List of group members
`memberCount`	number	Number of members returned

`microsoft_ad_add_group_member`

Input

Parameter	Type	Required	Description
`groupId`	string	Yes	No description
`memberId`	string	Yes	No description

Output

Parameter	Type	Description
`added`	boolean	Whether the member was added successfully
`groupId`	string	groupId output from the tool
`memberId`	string	Member ID that was added

`microsoft_ad_remove_group_member`

Input

Parameter	Type	Required	Description
`groupId`	string	Yes	No description
`memberId`	string	Yes	No description

Output

Parameter	Type	Description
`removed`	boolean	Whether the member was removed successfully
`groupId`	string	groupId output from the tool
`memberId`	string	Member ID that was removed

Azure AD

On this page