Microsoft Entra ID Integration

Field	Description	Required	Format
Client ID	Microsoft Entra ID OAuth App Client ID	Yes	`xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
Client Secret	Microsoft Entra ID OAuth App Client Secret	Yes	`xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

add_member_to_group — Add a user as a member to a Microsoft Entra ID group.

Parameters

string

required

Identifier of the group

string

required

Identifier of the user to add

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "AddMemberToGroupOutput",
  "type": "object"
}

create_group — Create a new group in Microsoft Entra ID.

Parameters

string

required

The name to display in the address book for the group

boolean

required

Set to true for mail-enabled groups

string

required

The mail alias for the group, unique for groups in the organization. Maximum length is 64 characters.

boolean

required

Set to true for security-enabled groups

Response

{
  "$defs": {
    "GroupSummary": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Display Name"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "mail_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail Enabled"
        },
        "mail_nickname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail Nickname"
        },
        "security_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Security Enabled"
        },
        "group_types": {
          "items": {
            "type": "string"
          },
          "title": "Group Types",
          "type": "array"
        },
        "deleted_date_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Deleted Date Time"
        }
      },
      "title": "GroupSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "group": {
      "anyOf": [
        {
          "$ref": "#/$defs/GroupSummary"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "success"
  ],
  "title": "CreateGroupOutput",
  "type": "object"
}

delete_group — Delete a group in Microsoft Entra ID.

Parameters

string

required

Identifier of the group to delete

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "DeleteGroupOutput",
  "type": "object"
}

get_manager — Get the user's manager information. Returns the user or organizational contact assigned as the user's manager.

Parameters

string

Identifier of the user. Leave empty to use the signed-in user.

Response

{
  "$defs": {
    "ManagerInfo": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Display Name"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "job_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Job Title"
        },
        "mobile_phone": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mobile Phone"
        }
      },
      "title": "ManagerInfo",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "manager": {
      "anyOf": [
        {
          "$ref": "#/$defs/ManagerInfo"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "message": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Message"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetManagerOutput",
  "type": "object"
}

get_ms365_groups — Get the user's Microsoft 365 groups (unified groups). Returns groups the user is a direct member of.

Parameters

string

Identifier of the user. Leave empty to use the signed-in user.

Response

{
  "$defs": {
    "GroupSummary": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Display Name"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "mail_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail Enabled"
        },
        "mail_nickname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail Nickname"
        },
        "security_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Security Enabled"
        },
        "group_types": {
          "items": {
            "type": "string"
          },
          "title": "Group Types",
          "type": "array"
        },
        "deleted_date_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Deleted Date Time"
        }
      },
      "title": "GroupSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "groups": {
      "items": {
        "$ref": "#/$defs/GroupSummary"
      },
      "title": "Groups",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetMs365GroupsOutput",
  "type": "object"
}

get_organization_groups — List all groups in the organization (excluding dynamic distribution groups).

Response

{
  "$defs": {
    "GroupSummary": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Display Name"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "mail_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail Enabled"
        },
        "mail_nickname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail Nickname"
        },
        "security_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Security Enabled"
        },
        "group_types": {
          "items": {
            "type": "string"
          },
          "title": "Group Types",
          "type": "array"
        },
        "deleted_date_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Deleted Date Time"
        }
      },
      "title": "GroupSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "groups": {
      "items": {
        "$ref": "#/$defs/GroupSummary"
      },
      "title": "Groups",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetOrganizationGroupsOutput",
  "type": "object"
}

get_organization_users — List all users in the organization. By default returns only enabled accounts.

Parameters

integer

Maximum number of users to return. Omit for no limit.

string

OData filter expression, e.g. ‘accountEnabled eq true’ (Default: accountEnabled eq true)

string

OData search expression, e.g. ‘“displayName:John“‘

Response

{
  "$defs": {
    "UserSummary": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "full_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Full Name"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "email": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Email"
        },
        "user_principal_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "User Principal Name"
        },
        "surname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Surname"
        },
        "given_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Given Name"
        },
        "job_title": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Job Title"
        },
        "mobile_phone": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mobile Phone"
        }
      },
      "title": "UserSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "users": {
      "items": {
        "$ref": "#/$defs/UserSummary"
      },
      "title": "Users",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetOrganizationUsersOutput",
  "type": "object"
}

get_profile — Get the user's profile information from Microsoft Entra ID.

Parameters

string

Identifier of the user. Leave empty to use the signed-in user.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "data": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Data"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetProfileOutput",
  "type": "object"
}

remove_member_from_group — Remove a member from a Microsoft Entra ID group.

Parameters

string

required

Identifier of the group

string

required

Identifier of the user to remove

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "RemoveMemberFromGroupOutput",
  "type": "object"
}

search_groups — Search for groups by name or description in Microsoft Entra ID.

Parameters

string

required

Keywords to search by

integer

The maximum number of groups to return (Default: 100)

Response

{
  "$defs": {
    "GroupSummary": {
      "additionalProperties": false,
      "properties": {
        "id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Id"
        },
        "display_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Display Name"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Description"
        },
        "mail_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail Enabled"
        },
        "mail_nickname": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Mail Nickname"
        },
        "security_enabled": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Security Enabled"
        },
        "group_types": {
          "items": {
            "type": "string"
          },
          "title": "Group Types",
          "type": "array"
        },
        "deleted_date_time": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Deleted Date Time"
        }
      },
      "title": "GroupSummary",
      "type": "object"
    }
  },
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "groups": {
      "items": {
        "$ref": "#/$defs/GroupSummary"
      },
      "title": "Groups",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SearchGroupsOutput",
  "type": "object"
}

update_group — Update an existing group in Microsoft Entra ID.

Parameters

string

required

Identifier of the group to update

boolean

Whether people external to the organization can send messages to the group

Whether new members added to the group will be auto-subscribed to receive email notifications

string

An optional description for the group

string

The name to display in the address book for the group

string

The mail alias for the group. Maximum length is 64 characters.

boolean

Set to true for security-enabled groups

string

Specifies the visibility of the group. Allowed values: Public, Private.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateGroupOutput",
  "type": "object"
}

update_user — Update an existing user in Microsoft Entra ID.

Parameters

string

required

Identifier of the user to update

string

The name to display in the address book for the user

string

The SMTP address for the user

string

The mail alias for the user

boolean

Whether the account is enabled (Default: true)

string

The street address of the user’s place of business

string

The city in which the user is located

string

The state or province in the user’s address

string

The postal code for the user’s postal address

string

The country/region in which the user is located

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    }
  },
  "required": [
    "success"
  ],
  "title": "UpdateUserOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Microsoft Entra ID Integration for AI Agents & Workflows

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Okta

Algolia

Amazon Web Services

Links

​Overview

​Authentication

​OAuth2 Authentication

​Required Credentials

​OAuth Configuration

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Okta

Algolia

Amazon Web Services

​Links

Overview

Authentication

OAuth2 Authentication

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links