n8n-docs/docs/integrations/builtin/credentials/microsoftentra.md

2.4 KiB

title description
Microsoft Entra ID credentials Documentation for the Microsoft Entra ID credentials. Use these credentials to authenticate Microsoft Entra ID in n8n, a workflow automation platform.

Microsoft Entra ID credentials

--8<-- "_snippets/integrations/builtin/credentials/cred-only-statement.md"

Prerequisites

Create a Microsoft Entra ID account or subscription.

Microsoft includes an Entra ID free plan when you create a Microsoft Azure{:target=_blank .external-link} account.

Supported authentication methods

  • OAuth2

Refer to Microsoft Entra ID's documentation{:target=_blank .external-link} for more information about the service.

This is a credential-only node. Refer to Custom API operations to learn more. View example workflows and related content{:target=_blank .external-link} on n8n's website.

Using OAuth2

--8<-- "_snippets/integrations/builtin/credentials/cloud-oauth-button.md"

If you need more detail on what's happening in the Microsoft OAuth web flow, refer to Microsoft authentication and authorization basics{:target=_blank .external-link}.

To configure OAuth2 from scratch, register an application with the Microsoft Identity Platform{:target=_blank .external-link}.

Use these settings for your application:

  • For Supported account types, select Accounts in any organizational directory (Any Azure AD directory - Multi-tenant) and personal Microsoft accounts (for example, Skype, Xbox).
  • Copy the OAuth Callback URL from n8n and use that as the Redirect URI in your Microsoft application.
  • Copy the Application (client) ID from your Microsoft application and add it as the Client ID in n8n.
  • Generate a new client secret in your application. Refer to the instructions in Add credentials{:target=_blank .external-link}.
  • Copy the secret's Value and add it as the Client Secret in n8n.