> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Entra ID

> How to set up the Microsoft Entra ID connector, plus the actions and events that are available.

![Microsoft Entra ID](https://stackone-logos.com/api/microsoft-entra-id/filled/svg)

v1.3.0[See changelog](https://docs.stackone.com/connectors/microsoftentraid/changelog.md)

[68 actions](#actions) · [6 events](#events) · 3 auth methods

IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 (Common) · Connector Profile](https://docs.stackone.com/connectors/microsoftentraid/guides/connector-profile/oauth-2-0-common.md)
>
> Requires registering an OAuth app in Microsoft Entra ID. Uses delegated permissions on behalf of a signed-in user.

> [card] [OAuth 2.0 (Tenant) · Connector Profile](https://docs.stackone.com/connectors/microsoftentraid/guides/connector-profile/oauth-2-0-tenant.md)
>
> Requires registering an OAuth app in Microsoft Entra ID. Restricts authentication to a single tenant using the Tenant ID...

> [card] [OAuth 2.0 (Client Credentials) · Connector Profile](https://docs.stackone.com/connectors/microsoftentraid/guides/connector-profile/oauth-2-0-client-credentials.md)
>
> App-only access to the whole directory, without a signed-in user. The Microsoft Graph application permissions are grante...

Optionally, configure receiving Events for Microsoft Entra ID into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/microsoftentraid/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 (Common) · Link Account](https://docs.stackone.com/connectors/microsoftentraid/guides/link-account/oauth-2-0-common.md)

> [card] [OAuth 2.0 (Tenant) · Link Account](https://docs.stackone.com/connectors/microsoftentraid/guides/link-account/oauth-2-0-tenant.md)

> [card] [OAuth 2.0 (Client Credentials) · Link Account](https://docs.stackone.com/connectors/microsoftentraid/guides/link-account/oauth-2-0-client-credentials.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

OAuth 2.0 (Client Credentials)

OAuth 2.0 (Common)

OAuth 2.0 (Tenant)

No auth methods found

Scopes

Select all
|
Clear

AppRoleAssignment.ReadWrite.All

Application.Read.All

Application.ReadWrite.All

DelegatedPermissionGrant.ReadWrite.All

Device.Read.All

Device.ReadWrite.All

Directory.AccessAsUser.All

Directory.Read.All

Domain.Read.All

Domain.ReadWrite.All

Group.ReadWrite.All

GroupMember.Read.All

GroupMember.ReadWrite.All

Organization.Read.All

Organization.ReadWrite.All

Policy.Read.All

Policy.ReadWrite.ConditionalAccess

RoleManagement.Read.Directory

RoleManagement.ReadWrite.Directory

User.Read.All

User.ReadWrite.All

No scopes found

68 actions

ActionDescriptionRequired scopes

List Users`microsoftentraid_list_users`

Retrieve a list of all users in the Microsoft Entra ID directory

`User.Read.All`

Get User`microsoftentraid_get_user`

Retrieve the properties and relationships of a specific user by ID or userPrincipalName

`User.Read.All`

Create User`microsoftentraid_create_user`

Create a new user in Microsoft Entra ID directory

`User.ReadWrite.All`

Update User`microsoftentraid_update_user`

Update the properties of a user in Microsoft Entra ID

`User.ReadWrite.All`

Delete User`microsoftentraid_delete_user`

Delete a user from Microsoft Entra ID directory

`User.ReadWrite.All`

List Groups`microsoftentraid_list_groups`

Retrieve a list of all groups in the Microsoft Entra ID directory

`GroupMember.Read.All`

Get Group`microsoftentraid_get_group`

Retrieve the properties of a specific group by ID

`GroupMember.Read.All`

Create Group`microsoftentraid_create_group`

Create a new group in Microsoft Entra ID

`Group.ReadWrite.All`

Update Group`microsoftentraid_update_group`

Update the properties of a group in Microsoft Entra ID

`Group.ReadWrite.All`

Delete Group`microsoftentraid_delete_group`

Delete a group from Microsoft Entra ID

`Group.ReadWrite.All`

List Group Members`microsoftentraid_list_group_members`

Retrieve the members of a group

`GroupMember.Read.All`

Add Group Member`microsoftentraid_add_group_member`

Add a member to a group

`GroupMember.ReadWrite.All`

Remove Group Member`microsoftentraid_remove_group_member`

Remove a member from a group

`GroupMember.ReadWrite.All`

List Organizations`microsoftentraid_list_organizations`

Retrieve a list of organizations (tenants) associated with the authenticated user

`Organization.Read.All`

Get Organization`microsoftentraid_get_organization`

Retrieve the properties of a specific organization (tenant) by ID

`Organization.Read.All`

Update Organization`microsoftentraid_update_organization`

Update the properties of a specific organization (tenant)

`Organization.ReadWrite.All`

List Applications`microsoftentraid_list_applications`

Retrieve a list of application registrations in Microsoft Entra ID

`Application.Read.All`

Get Application`microsoftentraid_get_application`

Retrieve the properties of a specific application by ID

`Application.Read.All`

Create Application`microsoftentraid_create_application`

Create a new application registration in Microsoft Entra ID

`Application.ReadWrite.All`

Update Application`microsoftentraid_update_application`

Update the properties of an application in Microsoft Entra ID

`Application.ReadWrite.All`

Delete Application`microsoftentraid_delete_application`

Delete an application from Microsoft Entra ID

`Application.ReadWrite.All`

List Directory Roles`microsoftentraid_list_directory_roles`

Retrieve a list of activated directory roles in Microsoft Entra ID

`RoleManagement.Read.Directory`

Get Directory Role`microsoftentraid_get_directory_role`

Retrieve the properties of a specific directory role by ID

`RoleManagement.Read.Directory`

List Directory Role Members`microsoftentraid_list_directory_role_members`

Retrieve the members of a directory role

`RoleManagement.Read.Directory`

Add Directory Role Member`microsoftentraid_add_directory_role_member`

Add a member to a directory role

`RoleManagement.ReadWrite.Directory`

Remove Directory Role Member`microsoftentraid_remove_directory_role_member`

Remove a member from a directory role

`RoleManagement.ReadWrite.Directory`

List Role Templates`microsoftentraid_list_role_templates`

Retrieve a list of all directory role templates in Microsoft Entra ID

`RoleManagement.Read.Directory`

List Service Principals`microsoftentraid_list_service_principals`

Retrieve a list of service principals (enterprise applications) in Microsoft Entra ID

`Application.Read.All`

Get Service Principal`microsoftentraid_get_service_principal`

Retrieve the properties of a specific service principal by ID

`Application.Read.All`

Create Service Principal`microsoftentraid_create_service_principal`

Create a new service principal for an application in Microsoft Entra ID

`Application.ReadWrite.All`

Update Service Principal`microsoftentraid_update_service_principal`

Update the properties of a service principal in Microsoft Entra ID

`Application.ReadWrite.All`

Delete Service Principal`microsoftentraid_delete_service_principal`

Delete a service principal from Microsoft Entra ID

`Application.ReadWrite.All`

List Service Principal App Role Assignments`microsoftentraid_list_service_principal_app_role_assignments`

Retrieve app role assignments granted to a service principal

`Application.Read.All`

Add App Role Assignment To Service Principal`microsoftentraid_add_service_principal_app_role_assignment`

Grant an app role to a service principal

`AppRoleAssignment.ReadWrite.All`

Remove App Role Assignment From Service Principal`microsoftentraid_remove_service_principal_app_role_assignment`

Remove an app role assignment from a service principal

`AppRoleAssignment.ReadWrite.All`

List Conditional Access Policies`microsoftentraid_list_conditional_access_policies`

Retrieve a list of all conditional access policies in Microsoft Entra ID

`Policy.Read.All`

Get Conditional Access Policy`microsoftentraid_get_conditional_access_policy`

Retrieve the properties of a specific conditional access policy by ID

`Policy.Read.All`

Create Conditional Access Policy`microsoftentraid_create_conditional_access_policy`

Create a new conditional access policy in Microsoft Entra ID

`Policy.ReadWrite.ConditionalAccess`

Update Conditional Access Policy`microsoftentraid_update_conditional_access_policy`

Update the properties of a conditional access policy in Microsoft Entra ID

`Policy.ReadWrite.ConditionalAccess`

Delete Conditional Access Policy`microsoftentraid_delete_conditional_access_policy`

Delete a conditional access policy from Microsoft Entra ID

`Policy.ReadWrite.ConditionalAccess`

List Named Locations`microsoftentraid_list_named_locations`

Retrieve a list of named locations used in conditional access policies

`Policy.Read.All`

Get Named Location`microsoftentraid_get_named_location`

Retrieve the properties of a specific named location by ID

`Policy.Read.All`

Create IP Named Location`microsoftentraid_create_ip_named_location`

Create a new IP-based named location for conditional access

`Policy.ReadWrite.ConditionalAccess`

Create Country Named Location`microsoftentraid_create_country_named_location`

Create a new country-based named location for conditional access

`Policy.ReadWrite.ConditionalAccess`

Delete Named Location`microsoftentraid_delete_named_location`

Delete a named location from Microsoft Entra ID

`Policy.ReadWrite.ConditionalAccess`

List Domains`microsoftentraid_list_domains`

Retrieve a list of domains associated with the Microsoft Entra ID tenant

`Domain.Read.All`

Get Domain`microsoftentraid_get_domain`

Retrieve the properties of a specific domain by domain name

`Domain.Read.All`

Create Domain`microsoftentraid_create_domain`

Add a new domain to Microsoft Entra ID

`Domain.ReadWrite.All`

Delete Domain`microsoftentraid_delete_domain`

Delete a domain from Microsoft Entra ID

`Domain.ReadWrite.All`

Verify Domain`microsoftentraid_verify_domain`

Verify a domain in Microsoft Entra ID

`Domain.ReadWrite.All`

List Domain Verification DNS Records`microsoftentraid_list_domain_verification_dns_records`

Retrieve DNS records required to verify domain ownership

`Domain.Read.All`

List Domain Service Configuration Records`microsoftentraid_list_domain_service_configuration_records`

Retrieve DNS records needed for services using the domain

`Domain.Read.All`

List Devices`microsoftentraid_list_devices`

Retrieve a list of devices registered in Microsoft Entra ID

`Device.Read.All`

Get Device`microsoftentraid_get_device`

Retrieve the properties of a specific device by ID

`Device.Read.All`

Create Device`microsoftentraid_create_device`

Create and register a new device object in Microsoft Entra ID

`Directory.AccessAsUser.All`

Update Device`microsoftentraid_update_device`

Update the properties of a device in Microsoft Entra ID

`Directory.AccessAsUser.All``Device.ReadWrite.All`

Delete Device`microsoftentraid_delete_device`

Delete a device from Microsoft Entra ID

`Directory.AccessAsUser.All``Device.ReadWrite.All`

List Device Registered Owners`microsoftentraid_list_device_registered_owners`

Retrieve the registered owners of a device

`Device.Read.All`

List Device Registered Users`microsoftentraid_list_device_registered_users`

Retrieve the registered users of a device

`Device.Read.All`

List Device Group Memberships`microsoftentraid_list_device_member_of`

Retrieve the groups that a device is a member of

`Device.Read.All`

List OAuth2 Permission Grants`microsoftentraid_list_oauth2_permission_grants`

Retrieve a list of delegated permission grants in Microsoft Entra ID

`Directory.Read.All`

Get OAuth2 Permission Grant`microsoftentraid_get_oauth2_permission_grant`

Retrieve a specific OAuth2 permission grant by ID

`Directory.Read.All`

Create OAuth2 Permission Grant`microsoftentraid_create_oauth2_permission_grant`

Create a new OAuth2 permission grant (delegated permission consent)

`DelegatedPermissionGrant.ReadWrite.All`

Update OAuth2 Permission Grant`microsoftentraid_update_oauth2_permission_grant`

Update an existing OAuth2 permission grant

`DelegatedPermissionGrant.ReadWrite.All`

Delete OAuth2 Permission Grant`microsoftentraid_delete_oauth2_permission_grant`

Delete an OAuth2 permission grant (revoke delegated permission consent)

`DelegatedPermissionGrant.ReadWrite.All`

List User App Role Assignments`microsoftentraid_list_user_app_role_assignments`

Retrieve app role assignments for a specific user

`Directory.Read.All`

Assign App Role To User`microsoftentraid_create_user_app_role_assignment`

Assign an app role to a user

`AppRoleAssignment.ReadWrite.All`

Remove App Role From User`microsoftentraid_delete_user_app_role_assignment`

Remove an app role assignment from a user

`AppRoleAssignment.ReadWrite.All`

## Events

Tags

Select all
|
Clear

Groups

Users

Webhooks

No tags found

6 events

EventDescriptionTags

Validation Check`microsoftentraid_webhook_validation_check`

Responds to Microsoft Graph subscription validation by returning the validationToken as plain text.

Webhooks

Subscription Lifecycle Notification`microsoftentraid_webhook_lifecycle_notification`

Acknowledges Microsoft Graph subscription lifecycle notifications.

Webhooks

User Updated`microsoftentraid_webhook_user_updated`

Fired when a user is created, changed, soft-deleted or restored.

UsersWebhooks

User Deleted`microsoftentraid_webhook_user_deleted`

Fired when a user is permanently deleted.

UsersWebhooks

Group Updated`microsoftentraid_webhook_group_updated`

Fired when a group is changed, has members added or removed, or is soft-deleted or restored.

GroupsWebhooks

Group Deleted`microsoftentraid_webhook_group_deleted`

Fired when a group is permanently deleted.

GroupsWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.