GroupMgr (Preview)

  • Reference

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

Operation ID:
GroupMgrGroupApproval

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

Body
GroupExtended

Archive or Unarchive a group

Operation ID:
GroupMgrArchiveGroup

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

Operation ID:
GroupMgrCreateGroup

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

Body
GroupExtended

Delete a group

Operation ID:
GroupMgrDeleteGroup

Delete a group.

Parameters

Name Key Required Type Description
GroupMgr ID
 ListItemId True string

GroupMgr internal Id.

Returns

Update a group

Operation ID:
GroupMgrUpdateGroup

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

Body
GroupExtended

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

Operation ID:
GroupMgrGroupDeleted

This will trigger when a group is removed.

Returns

Body
GroupExtended

When a group is updated

Operation ID:
GroupMgrGroupUpdated

This will trigger when a group is updated.

Returns

Body
GroupUpdated

When a new group is created

Operation ID:
GroupMgrGroupCreated

This will trigger when a new group is created.

Returns

Body
GroupExtended

When a new group is requested. (Approval flow)

Operation ID:
GroupMgrGroupRequested

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

Body
GroupCompact

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.