Microsoft Entra Agent ID icon

Microsoft Entra Agent ID

Manage Entra agent identity blueprints, agent users, and federated credentials via Microsoft Graph.

3 triggers10 searches21 actionsPollingAuth: OAuth

AI-assisted documentation17 min read

This documentation is compiled from our integration source code, internal specs for Microsoft Entra Agent ID, its official API documentation and anonymized requests logs we collect from our support team[2].

Open Microsoft Entra Agent ID on WEXTL →

Connecting Microsoft Entra Agent ID takes an active account plus OAuth client credentials, granted by signing in with your account — no other setup is required.[3]

Credential type option 1

Microsoft Agent - Secondary

You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.

  • Microsoft - TenantselectRequired

    Go to https://entra.microsoft.com and copy your tennat ID or select any of the following`

    [1]
  • Microsoft - Client IDtextRequired

    Go to the Microsoft Entra admin center → Entra ID → App registrations and select New registration. → enter a description and expiration → Add, then immediately copy your Client ID

    [1]
  • Microsoft - Client SecretpasswordRequired

    Copy you client Secret from the previously created app

    [1]
Integration requests 20 permissions:
AgentIdentity.Read.AllAgentIdentity.ReadWrite.AllAgentIdentity.EnableDisable.AllAgentIdentity.DeleteRestore.AllAgentIdentityBlueprint.Read.AllAgentIdentityBlueprint.ReadWrite.AllAgentIdentityBlueprint.CreateAgentIdUser.ReadWrite.AllAgentCard.Read.AllAgentCard.ReadWrite.AllAgentCardManifest.Read.AllAgentCardManifest.ReadWrite.AllAgentCollection.Read.AllAgentCollection.ReadWrite.AllAgentInstance.Read.AllAgentInstance.ReadWrite.AllAgentRegistration.Read.AllAgentRegistration.ReadWrite.Alloffline_accessUser.Read
Credential type option 2

Microsoft Agent - Primary

You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.

  • Microsoft - TenanttextRequired

    Directory (tenant) ID or verified domain, e.g. contoso.onmicrosoft.com. common/organizations/consumers are not valid for app-only.

    [1]
  • Microsoft - Client IDtextRequired

    Register your application in the Microsoft Entra admin center, then copy the Application (client) ID from the app's Overview page

    [1]
  • Microsoft - Client SecretpasswordRequired

    In your app registration, go to Certificates & secrets → Client secrets, create a new client secret, and copy its value immediately after it's generated.

    [1]
Integration requests 18 permissions:
AgentIdentity.Read.AllAgentIdentity.ReadWrite.AllAgentIdentity.EnableDisable.AllAgentIdentity.DeleteRestore.AllAgentIdentityBlueprint.Read.AllAgentIdentityBlueprint.ReadWrite.AllAgentIdentityBlueprint.CreateAgentIdUser.ReadWrite.AllAgentCard.Read.AllAgentCard.ReadWrite.AllAgentCardManifest.Read.AllAgentCardManifest.ReadWrite.AllAgentCollection.Read.AllAgentCollection.ReadWrite.AllAgentInstance.Read.AllAgentInstance.ReadWrite.AllAgentRegistration.Read.AllAgentRegistration.ReadWrite.All
  1. Log in to your WEXTL account, add the Microsoft Entra Agent ID node module to your workflow, and click Create new credential.
  2. Optional: In the Credential name field, enter a name for the credential.
  3. Enter the authentication credentials you copied from your Microsoft Entra Agent ID account, or follow the on-screen instructions to create the credential.
  4. If prompted, authenticate your account and confirm access.
  5. If you want to make changes to your credential in the future, follow the steps in Manage credentials →
Connecting Microsoft Entra Agent ID to WEXTL®
Video slide demonstrates how to integrate Microsoft Entra Agent ID in the WEXTL visual workflow builder.[4]

Notes

Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →

Watch Agent BlueprintsTrigger
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Identifier urisarray
Created by app IDtext
Created date timedate
Descriptiontext
Disabled by microsoft statustext
Display nametext
Group membership claimstext
Publisher domaintext
Sign in audiencetext
Tagsarray
Token encryption key IDtext
Unique nametext
Service management referencetext
Optional claimstext
APIobject
Requested access token versionnumber
Accept mapped claimstext
Known client applicationsarray
Oauth 2permission scopesarray
Pre authorized applicationsarray
Token encryption settingobject
App rolesarray
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
5other output fields
Watch Agent Identity Blueprints PrincipalTrigger
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Created date timedate
Created by app IDtext
Account enabledboolean
App display nametext
App owner organization IDtext
App role assignment requiredboolean
App rolesarray
Disabled by microsoft statustext
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
Oauth 2permission scopesarray
Service principal typetext
Tagsarray
Verified publishertext
Watch Agent UserTrigger
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Created date timedate
Created by app IDtext
Account enabledboolean
App display nametext
App owner organization IDtext
App role assignment requiredboolean
App rolesarray
Disabled by microsoft statustext
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
Oauth 2permission scopesarray
Service principal typetext
Tagsarray
Verified publishertext
List Agent BlueprintsSearch
Input fields[3]
FieldType
Limitnumber
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Identifier urisarray
Created by app IDtext
Created date timedate
Descriptiontext
Disabled by microsoft statustext
Display nametext
Group membership claimstext
Publisher domaintext
Sign in audiencetext
Tagsarray
Token encryption key IDtext
Unique nametext
Service management referencetext
Optional claimstext
APIobject
Requested access token versionnumber
Accept mapped claimstext
Known client applicationsarray
Oauth 2permission scopesarray
Pre authorized applicationsarray
Token encryption settingobject
App rolesarray
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
5other output fields
List Agent Identity Blueprints PrincipalSearch
Input fields[3]
FieldType
Limitnumber
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Created date timedate
Created by app IDtext
Account enabledboolean
App display nametext
App owner organization IDtext
App role assignment requiredboolean
App rolesarray
Disabled by microsoft statustext
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
Oauth 2permission scopesarray
Service principal typetext
Tagsarray
Verified publishertext
List Agent UserSearch
Input fields[3]
FieldType
Limitnumber
Output fields[3]
FieldType
@odata typetext
IDtext
Deleted date timedate
Sign in activityobject
@odata typetext
Cloud licensingobject
@odata typetext
Account enabledtext
Age grouptext
Assigned licensesarray
Assigned plansarray
Authorization infotext
Business phonesarray
Citytext
Cloud realtime communication infoobject
@odata typetext
Company nametext
Consent provided for minortext
Countrytext
Created date timedate
Creation typetext
Departmenttext
Display nametext
64other output fields
List App Role AssignmentSearch
Input fields[3]
FieldType
Application IDRequired
choice
Limitnumber
Output fields[3]
FieldType
IDtext
Created date timedate
App role IDtext
Principal display nametext
Principal IDtext
Principal typetext
Resource display nametext
Resource IDtext
List App Roles AssignedSearch
Input fields[3]
FieldType
Application IDRequired
choice
Limitnumber
Output fields[3]
FieldType
IDtext
Deleted date timetext
App role IDtext
Created date timedate
Principal display nametext
Principal IDtext
Principal typetext
Resource display nametext
Resource IDtext
List Federated Identity CredentialsSearch
Input fields[3]
FieldType
Application IDRequired
choice
Limitnumber
Output fields[3]
FieldType
@odata IDtext
IDtext
Nametext
Issuertext
Subjecttext
Descriptiontext
Audiencesarray
Retrieve a Federated Identity CredentialAction
Input fields[3]
FieldType
Application IDRequired
choice
Audiencesarray
Audiencetext
Issuerurl
Nametext
Subjecttext
Output fields[3]
FieldType
@odata IDtext
IDtext
Nametext
Issuertext
Subjecttext
Descriptiontext
Audiencesarray
Retrieve an Agent BlueprintAction
Input fields[3]
FieldType
Object IDRequired
choice
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Identifier urisarray
Created by app IDtext
Created date timedate
Descriptiontext
Disabled by microsoft statustext
Display nametext
Group membership claimstext
Publisher domaintext
Sign in audiencetext
Tagsarray
Token encryption key IDtext
Unique nametext
Service management referencetext
Optional claimstext
APIobject
Requested access token versionnumber
Accept mapped claimstext
Known client applicationsarray
Oauth 2permission scopesarray
Pre authorized applicationsarray
Token encryption settingobject
App rolesarray
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
5other output fields
Retrieve an Agent Identiy Blueprint PrincipalAction
Input fields[3]
FieldType
Agent Identity Blueprint Principal IDRequired
choice
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Created date timedate
Created by app IDtext
Account enabledboolean
App display nametext
App owner organization IDtext
App role assignment requiredboolean
App rolesarray
Disabled by microsoft statustext
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
Oauth 2permission scopesarray
Service principal typetext
Tagsarray
Verified publishertext
Retrieve an Agent UserAction
Input fields[3]
FieldType
Agent User IDRequired
choice
Output fields[3]
FieldType
@odata typetext
IDtext
Deleted date timedate
Sign in activityobject
@odata typetext
Cloud licensingobject
@odata typetext
Account enabledtext
Age grouptext
Assigned licensesarray
Assigned plansarray
Authorization infotext
Business phonesarray
Citytext
Cloud realtime communication infoobject
@odata typetext
Company nametext
Consent provided for minortext
Countrytext
Created date timedate
Creation typetext
Departmenttext
Display nametext
64other output fields
Add an Agent Blueprint KeyAction
Input fields[3]
FieldType
Object IDRequired
choice
Key CredentialRequired
object
TypeRequired
choice
UsageRequired
choice
KeyRequired
text
Password Credentialobject
Secret Textsecret
Prooftext
Output fields[3]
FieldType
@odata typetext
Custom key identifiertext
Display nametext
End date timedate
Keytext
Key IDtext
Start date timedate
Typetext
Usagetext
Add an Agent Blueprint PasswordAction
Input fields[3]
FieldType
Object IDRequired
choice
Display Nametext
Start Date Timedate
End Date Timedate
Output fields[3]
FieldType
Custom key identifiertext
End date timedate
Key IDtext
Start date timedate
Secret texttext
Hinttext
Display nametext
Add App Role AssignmentAction
Input fields[3]
FieldType
Application IDRequired
choice
Principal Display NameRequired
text
App Role IDRequired
choice
Principal IDRequired
choice
Resource IDRequired
choice
Resource Display Nametext
Output fields[3]
FieldType
@odata contexttext
IDtext
Created date timedate
App role IDtext
Principal display nametext
Principal IDtext
Principal typetext
Resource display nametext
Resource IDtext
Assign App RoleAction
Input fields[3]
FieldType
Application IDRequired
choice
Principal Display NameRequired
text
App Role IDRequired
choice
Principal IDRequired
choice
Resource IDRequired
choice
Resource Display Nametext
Output fields[3]
FieldType
App role IDtext
Created date timedate
Deleted date timedate
IDtext
Principal display nametext
Principal IDtext
Principal typetext
Resource display nametext
Resource IDtext
Create a Federated Identity CredentialAction
Input fields[3]
FieldType
Application IDRequired
choice
AudiencesRequired
array
Audiencetext
IssuerRequired
url
NameRequired
text
SubjectRequired
text
Output fields[3]
FieldType
@odata IDtext
IDtext
Nametext
Issuertext
Subjecttext
Descriptiontext
Audiencesarray
Create an Agent BlueprintAction
Input fields[3]
FieldType
Display NameRequired
text
SponsorsRequired
choice
Descriptiontext
Identifier URIsarray
URIurl
Tagsarray
Tagtext
Sign-In Audiencechoice
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Identifier urisarray
Created by app IDtext
Created date timedate
Descriptiontext
Disabled by microsoft statustext
Display nametext
Group membership claimstext
Publisher domaintext
Sign in audiencetext
Tagsarray
Token encryption key IDtext
Unique nametext
Service management referencetext
Optional claimstext
APIobject
Requested access token versionnumber
Accept mapped claimstext
Known client applicationsarray
Oauth 2permission scopesarray
Pre authorized applicationsarray
Token encryption settingobject
App rolesarray
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
5other output fields
Create an Agent Identiy Blueprint PrincipalAction
Input fields[3]
FieldType
Account EnabledRequired
boolean
Display NameRequired
text
App Display NameRequired
text
App IDRequired
choice
App Descriptiontext
App Owner Organization IDtext
App Role Assignment Requiredboolean
App Rolesarray
Disabled By Microsoft Statustext
Informational URLobject
Published Permission Scopesarray
Publisher Nametext
Service Principal Namesarray
Service Principal Nametext
Service Principal Typetext
Tagsarray
Tagtext
Verified Publisherobject
Output fields[3]
FieldType
@odata typetext
IDtext
App IDtext
Created date timedate
Created by app IDtext
Account enabledboolean
App display nametext
App owner organization IDtext
App role assignment requiredboolean
App rolesarray
Disabled by microsoft statustext
Infoobject
Terms of service URLurl
Support URLurl
Privacy statement URLurl
Marketing URLurl
Logo URLurl
Oauth 2permission scopesarray
Service principal typetext
Tagsarray
Verified publishertext
Create an Agent UserAction
Input fields[3]
FieldType
Identity Parent IDRequired
choice
Display NameRequired
text
Account Enabledboolean
Mail Nicknametext
User Principal Nametext
Output fields[3]
FieldType
@odata typetext
IDtext
Deleted date timedate
Sign in activityobject
@odata typetext
Cloud licensingobject
@odata typetext
Account enabledtext
Age grouptext
Assigned licensesarray
Assigned plansarray
Authorization infotext
Business phonesarray
Citytext
Cloud realtime communication infoobject
@odata typetext
Company nametext
Consent provided for minortext
Countrytext
Created date timedate
Creation typetext
Departmenttext
Display nametext
64other output fields
Delete a Federated Identity CredentialAction
Input fields[3]
FieldType
Application IDRequired
choice
Audiencesarray
Audiencetext
Issuerurl
Nametext
Subjecttext
Delete an Agent BlueprintAction
Input fields[3]
FieldType
Object IDRequired
choice
Delete an Agent Identiy Blueprint PrincipalAction
Input fields[3]
FieldType
Agent Identity Blueprint Principal IDRequired
choice
Delete an Agent UserAction
Input fields[3]
FieldType
Agent User IDRequired
choice
Delete App Role AssignedAction
Input fields[3]
FieldType
Application IDRequired
choice
Delete App Role AssignmentAction
Input fields[3]
FieldType
Application IDRequired
choice
Make an API Calluniversal
Input fields[3]
FieldType
URLRequired
text
MethodRequired
choice
Headersarray
Headerobject
Query Stringarray
Parameterobject
Bodytext
Output fields[3]
FieldType
Bodytext
Headersobject
Status codenumber
Remove an Agent Blueprint KeyAction
Input fields[3]
FieldType
Object IDRequired
choice
Remove an Agent Blueprint PasswordAction
Input fields[3]
FieldType
Object IDRequired
choice
Update an Agent BlueprintAction
Input fields[3]
FieldType
Object IDRequired
choice
Display Nametext
Descriptiontext
Identifier URIsarray
URIurl
Tagsarray
Tagtext
Sign-In Audiencechoice
Sponsorschoice
Update an Agent Identiy Blueprint PrincipalAction
Input fields[3]
FieldType
Agent Identity Blueprint Principal IDRequired
choice
Account Enabledboolean
Display Nametext
App Display Nametext
App IDchoice
App Descriptiontext
App Owner Organization IDtext
App Role Assignment Requiredboolean
App Rolesarray
Disabled By Microsoft Statustext
Informational URLobject
Published Permission Scopesarray
Publisher Nametext
Service Principal Namesarray
Service Principal Nametext
Service Principal Typetext
Tagsarray
Tagtext
Verified Publisherobject
Update an Agent UserAction
Input fields[3]
FieldType
Agent User IDRequired
choice
Identity Parent IDchoice
Display Nametext
Account Enabledboolean
Mail Nicknametext
User Principal Nametext
Update Federated Identity CredentialAction
Input fields[3]
FieldType
Application IDRequired
choice
Audiencesarray
Audiencetext
Issuerurl
Nametext
Subjecttext

Look for Microsoft Entra Agent ID templates in the WEXTL template library.

Browse templates →
  1. WEXTL® Microsoft Entra Agent ID Source Code connector implementation.
  2. Our users use cases and automations.
  3. Official API Documentation for Microsoft Entra Agent ID.
  4. WEXTL® visual workflow builder data.

Last updated: Jul 24, 2026 18:12