Office 365 Groups

Office 365 Groups lets you manage group membership and calendar events in your organization using your Office 365 account. You can perform various actions such as get group roster, add or remove members and create group events.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds
Frequency of trigger polls1120 seconds

Actions

Add member to group

This operation is used to add a member to an O365 group, using a UPN.

Create a group event

This operation is used to create a new event in a group calendar.

Create a group event (V2)

This operation is used to create a new event in a group calendar.

List group members

This operation returns a list of all members in the given group and their details such as name, title, email, etc.

List groups that I owned and belong to

This operation returns a list of all groups that you own and belong to.

List my owned groups

This operation returns a list of all groups that you own.

Remove member from group

This operation is used to remove a member from an O365 group, using a UPN.

Add member to group

This operation is used to add a member to an O365 group, using a UPN.

Parameters

Name Key Required Type Description
Group Id
groupId True guid

Pick a group from the drop down or enter group id.

User Principal Name
userUpn True string

The user principal name (UPN) of the user.

Create a group event

This operation is used to create a new event in a group calendar.

Parameters

Name Key Required Type Description
Group Id
groupId True guid

Pick a group from the drop down or enter group id.

Subject
subject True string

Title of the event.

Start Time
dateTime True date-time

Start time of the event (example: '2016-11-01T14:30:00').

End Time
dateTime True date-time

End time of the event (example: '2016-11-01T15:30:00').

Body
content string

Body of the message associated with the event.

Body Content Type
contentType string

Pick the content type: Text or Html.

Location
displayName string

Location of the event.

Importance
importance string

The importance of the event: Low, Normal, or High.

Is All Day
isAllDay boolean

Set to true if the event lasts all day.

Is Reminder On
isReminderOn boolean

Set to true if the event has a reminder.

Reminder Start Duration
reminderMinutesBeforeStart integer

Time in minutes before event start to remind.

Show As
showAs string

Status to show during the event.

Response Requested
responseRequested boolean

Set to true if the sender would like a response when the event is accepted or declined.

Returns

Create a group event (V2)

This operation is used to create a new event in a group calendar.

Parameters

Name Key Required Type Description
Group Id
groupId True guid

Pick a group from the drop down or enter group id.

Subject
subject True string

Title of the event.

Start Time
dateTime True date-time

Start time of the event (example: '2016-11-01T14:30:00').

End Time
dateTime True date-time

End time of the event (example: '2016-11-01T15:30:00').

Body
content html

Body of the message associated with the event.

Location
displayName string

Location of the event.

Importance
importance string

The importance of the event: Low, Normal, or High.

Is All Day
isAllDay boolean

Set to true if the event lasts all day.

Is Reminder On
isReminderOn boolean

Set to true if the event has a reminder.

Reminder Start Duration
reminderMinutesBeforeStart integer

Time in minutes before event start to remind.

Show As
showAs string

Status to show during the event.

Response Requested
responseRequested boolean

Set to true if the sender would like a response when the event is accepted or declined.

Returns

List group members

This operation returns a list of all members in the given group and their details such as name, title, email, etc.

Parameters

Name Key Required Type Description
Group Id
groupId True guid

Pick a group from the drop down or enter group id.

Top
$top integer

Number of group members to retrieve (from 1 to 999, default is 100).

Returns

List groups that I owned and belong to

This operation returns a list of all groups that you own and belong to.

Returns

List my owned groups

This operation returns a list of all groups that you own.

Returns

Remove member from group

This operation is used to remove a member from an O365 group, using a UPN.

Parameters

Name Key Required Type Description
Group Id
groupId True guid

Pick a group from the drop down or enter group id.

User Principal Name
userUpn True string

The user principal name (UPN) of the user

Triggers

When a group member is added or removed

This operation triggers when a member is added to or removed from the given group.

When there is a new event

This operation triggers when a new event is added to a group calendar.

When a group member is added or removed

This operation triggers when a member is added to or removed from the given group.

Parameters

Name Key Required Type Description
Group Id
groupId True guid

Pick a group from the drop down or enter group id.

Returns

Name Path Type Description
User Id
id string

Unique id of the user.

Reason
@removed.reason string

Reason that caused the user to be removed from the group.

When there is a new event

This operation triggers when a new event is added to a group calendar.

Parameters

Name Key Required Type Description
Group Id
groupId True guid

Pick a group from the drop down or enter group id.

Returns

Name Path Type Description
Id
id string

Unique id of the event.

Reminder Start Duration
reminderMinutesBeforeStart integer

The number of minutes before the start of the event the reminder will fire.

Is Reminder On
isReminderOn boolean

Set to true if the event has a reminder.

Subject
subject string

Title of the event.

Importance
importance string

The importance of the event: Low, Normal, or High.

Is All Day
isAllDay boolean

Set to true if the event lasts all day.

Response Requested
responseRequested boolean

Set to true if the sender would like a response when the event is accepted or declined.

Show As
showAs string

Status to show during the event.

Content Type
body.contentType string

Body of the message associated with the event.

Content
body.content string

Pick the content type: Text or Html.

Date Time
start.dateTime date-time

Start time of the event (example: '2016-11-01T14:30:00-07:00').

Time Zone
start.timeZone string

Time zone of the event, specified as a time zone index value (example: 'Pacific Standard Time').

Date Time
end.dateTime date-time

End time of the event (example: '2016-11-01T15:30:00-07:00').

Time Zone
end.timeZone string

Time zone of the event, specified as a time zone index value (example: 'Pacific Standard Time').

Name
location.displayName string

The display name for the location of the event.

Definitions

ListGroupMembers_Response

Name Path Type Description
value
value array of object

value

User Id
value.id string

Unique id of the user.

Display Name
value.displayName string

User's display name.

Given Name
value.givenName string

User's first name.

Job Title
value.jobTitle string

User's job title.

Mail
value.mail string

User's email address.

Mobile Phone
value.mobilePhone string

User's mobile number.

Office Location
value.officeLocation string

User's office address.

Surname
value.surname string

User's last name.

User Principal Name
value.userPrincipalName string

UPN id of the user.

ListOwnedGroups_Response

Name Path Type Description
value
value array of object

value

Classification
value.classification string

O365 group classification.

Created Date-Time
value.createdDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 format, UTC timezone)

Deleted Date-Time
value.deletedDateTime string

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 format, UTC timezone)

Description
value.description string

More information about the group.

Name
value.displayName string

O365 group name.

Group Id
value.id string

Unique identifier of the group.

Email
value.mail string

Email address of the group.

Mail Enabled
value.mailEnabled boolean

True if mail is enabled for the group.

Nickname
value.mailNickname string

Group nickname.

On-Premises Last Sync Date-Time
value.onPremisesLastSyncDateTime string

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 format, UTC timezone)

On-Premises Security Identifier
value.onPremisesSecurityIdentifier string

The on-premises security identifier.

On-Premises Sync Enabled
value.onPremisesSyncEnabled string

True if on-premises sync is enabled for the group.

Renewed Date-Time
value.renewedDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 format, UTC timezone)

Security Enabled
value.securityEnabled boolean

True if the owner is security enabled.

Visibility
value.visibility string

The owner's visibility.

ListOwnedGroups_V2_Response

Name Path Type Description
value
value array of object

value

Classification
value.classification string

O365 group classification.

Created Date-Time
value.createdDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 format, UTC timezone)

Description
value.description string

More information about the group.

Name
value.displayName string

O365 group name.

Group Id
value.id string

Unique identifier of the group.

Email
value.mail string

Email address of the group.

Mail Enabled
value.mailEnabled boolean

True if mail is enabled for the group.

Nickname
value.mailNickname string

Group nickname.

On-Premises Last Sync Date-Time
value.onPremisesLastSyncDateTime string

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 format, UTC timezone)

On-Premises Security Identifier
value.onPremisesSecurityIdentifier string

The on-premises security identifier.

On-Premises Sync Enabled
value.onPremisesSyncEnabled string

True if on-premises sync is enabled for the group.

Renewed Date-Time
value.renewedDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (ISO8601 format, UTC timezone)

Security Enabled
value.securityEnabled boolean

True if the owner is security enabled.

Visibility
value.visibility string

The owner's visibility.

CreateCalendarEvent_Response

Name Path Type Description
Id
id string

Unique id of the event.

Reminder Start Duration
reminderMinutesBeforeStart integer

Time in minutes before event starts to remind.

Is Reminder On
isReminderOn boolean

Set to true if the event has a reminder.

Subject
subject string

Title of the event.

Importance
importance string

The importance of the event: Low, Normal, or High.

Is All Day
isAllDay boolean

True if the event is an all day event.

Response Requested
responseRequested boolean

True if a response was requested for the event.

Show As
showAs string

Status to show during the event.

Content Type
body.contentType string

Text or Html.

Content
body.content string

The content of the body of this event.

Date Time
start.dateTime date-time

Start time of the event (example: '2016-11-01T14:30:00-07:00').

Time Zone
start.timeZone string

Time zone of the event, specified as a time zone index value (example: 'Pacific Standard Time').

Date Time
end.dateTime date-time

End time of the event (example: '2016-11-01T15:30:00-07:00').

Time Zone
end.timeZone string

Time zone of the event, specified as a time zone index value (example: 'Pacific Standard Time').

Name
location.displayName string

The display name for the location of the event.