Compartilhar via


GroupMgr (Preview)

A powerful set of tools, for both IT managers and users, to efficiently create, manage, browse and analyse all groups in your Microsoft 365 environment.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name GroupMgr Helpdesk
URL https://www.vanroey.be/en/support/
Email support@groupmgr.com
Connector Metadata
Publisher GroupMgr
Website https://groupmgr.com/
Privacy policy https://groupmgr.com/privacy
Categories IT Operations;Productivity

A powerful set of tools, for both IT managers and users, to efficiently create, manage, browse and analyse all groups in your Microsoft 365 environment. People love using Microsoft Teams. However, every time a team is created, a ‘group’ and a lot of underlying assets like mailboxes, SharePoint sites, planners and documents are created as well… Managing all this content is near impossible. GroupMgr is a governance tool which gives you that much needed overview of all existing groups, their users and related assets.

Our app will manage Microsoft 365 groups within your tenant. It provides users with an overview of all the currently available groups and allows them to easily create new ones. In addition, admins will be able to connect approval flows to the creation of new groups. This is done by connecting an approval flow to a group type. Besides, relationship between groups and group types will give a clearer overview of all available groups and makes it easier for users to filter or search them. If a user creates a new group, linked to a group type with an approval flow, the flow must be completed first, before the group itself will be created. In order to set up such approval flows, our custom connector must be used.

The connector will place a webhook on the Creation and Update part of the CRUD which will trigger the connector when needed. The connector consists of two parts, a trigger and an action. The trigger will fire when an group is created or updated. The action is used to send a reply with the approval result. Based on this approval result, the Microsoft 365 group will either be created or declined.

Pre-requisites

You will need the following to proceed:

  • A Microsoft Power Automate plan with custom connector feature,
  • A GroupMgr license,
  • GroupMgr API authentication details.

Get the API key for the GroupMgr

Support, policies and more infomartion :

You can find these resources here:

Creating a connection

The connector supports the following authentication types:

Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API key securestring API key for your GroupMgr connection True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Approve or Reject a requested group

Will send an approval back to GroupMgr for the requested group.

Archive or Unarchive a group

Archive a group. Make SharePoint and Teams read-only for this group.

Create a group

Create a new group.

Delete a group

Delete a group.

Update a group

Update an existing group.

Approve or Reject a requested group

Will send an approval back to GroupMgr for the requested group.

Parameters

Name Key Required Type Description
GroupMgr ID
ListItemId True string

GroupMgr internal Id.

Action
Approved True string

Group action.

Returns

Archive or Unarchive a group

Archive a group. Make SharePoint and Teams read-only for this group.

Parameters

Name Key Required Type Description
GroupMgr ID
ListItemId True string

GroupMgr internal Id.

Action
Archive True string

Group action.

Returns

Create a group

Create a new group.

Parameters

Name Key Required Type Description
Display name
DisplayName True string

Display name of the group.

Email
Email True string

Email of the group.

Owner emails
Owners True array of string

Owner emails.

Member emails
Members array of string

Member emails.

Group type
GroupType string

Group type of the group.

Private or Public
IsPublic string

Is the group private or public.

Create a team
CreateTeam boolean

Create a team for the group.

Description
Description string

Description for the group creation.

Created by
CreatedBy string

User that created the group.

Returns

Delete a group

Delete a group.

Parameters

Name Key Required Type Description
GroupMgr ID
ListItemId True string

GroupMgr internal Id.

Returns

Update a group

Update an existing group.

Parameters

Name Key Required Type Description
Group ID
GroupId True string

The ID of the group you want to update.

Display name
DisplayName string

Display name of the group.

Owner emails
Owners array of string

Owner emails.

Member emails
Members array of string

Member emails.

Group type
GroupType string

Group type of the group.

Is public
IsPublic string

Is the group public.

Create a team
CreateTeam boolean

Create a team for the group.

Description
Description string

Description for the group creation.

Returns

Triggers

When a group is removed

This will trigger when a group is removed.

When a group is updated

This will trigger when a group is updated.

When a new group is created

This will trigger when a new group is created.

When a new group is requested. (Approval flow)

This will trigger when a new group is requested within GroupMgr (Only groups with this approval flow).

When a group is removed

This will trigger when a group is removed.

Returns

When a group is updated

This will trigger when a group is updated.

Returns

When a new group is created

This will trigger when a new group is created.

Returns

When a new group is requested. (Approval flow)

This will trigger when a new group is requested within GroupMgr (Only groups with this approval flow).

Parameters

Name Key Required Type Description
Approval name
name True string

Name for this approval flow.

Returns

Definitions

GroupUpdated

Name Path Type Description
Group Id
GroupId string

Id of the group in Microsoft 365.

GroupMgr Id
ListItemId string

GroupMgr internal Id.

Display name
DisplayName string

Display name of the group.

Email
Email string

Email of the group.

Owners
Owners array of string

Owner emails.

Members
Members array of string

Member emails.

Group type
GroupType string

Group type of the group.

Is public
IsPublic boolean

Is the group public.

Status
Status string

Status of the Group.

URL SharePoint
Url string

URL of the SharePoint page.

URL Teams
TeamsUrl string

URL of the Team page.

Fields changed
FieldsChanged array of string

Fields changed in the update.

Create a Team
CreateTeam boolean

Create a team for the group.

Description
Description string

Description for the group creation.

Created by
CreatedBy string

User that created the group.

GroupExtended

Name Path Type Description
Group Id
GroupId string

Id of the group in Microsoft 365.

GroupMgr Id
ListItemId string

GroupMgr internal Id.

Display name
DisplayName string

Display name of the group.

Email
Email string

Email of the group.

Owners
Owners array of string

Owner emails.

Members
Members array of string

Member emails.

Group type
GroupType string

Group type of the group.

Is public
IsPublic boolean

Is the group public.

Status
Status string

Status of the Group.

URL SharePoint
Url string

URL of the SharePoint page.

URL Teams
TeamsUrl string

URL of the Team page.

Create a Team
CreateTeam boolean

Create a team for the group.

Description
Description string

Description for the group creation.

Created by
CreatedBy string

User that created the group.

GroupCompact

Name Path Type Description
Display name
DisplayName string

Display name of the group/

GroupMgr Id
ListItemId string

GroupMgr internal Id.

Email
Email string

Email of the group.

Owners
Owners array of string

Owner emails.

Members
Members array of string

Member emails.

Group type
GroupType string

Group type of the group.

Is public
IsPublic boolean

Is the group public.

Create a Team
CreateTeam boolean

Create a team for the group.

Created by
CreatedBy string

User that created the group.

Description
Description string

Description for the group creation.