Office 365 Groups

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.

Note:

  • This is a Standard connector.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds
Frequency of trigger polls 1 120 seconds

Actions

Add member to group

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

Required Parameters

Group Id
guid
Pick a group from the drop down or enter group id.
User's Email
string
A user's fully qualified email address (ex. user@microsoft.com).

Create a group event

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

Required Parameters

Group Id
guid
Pick a group from the drop down or enter group id.
Subject
string
Title of the event.
Start Time
date-time
Start time of the event (example: '2016-11-01T14:30:00-07:00').
End Time
date-time
End time of the event (example: '2016-11-01T15:30:00-07:00').

Optional Parameters

Body
string
Body of the message associated with the event.
Body Content Type
string
Pick the content type: Text or Html.
Location
string
Location of the event.
Importance
string
The importance of the event: Low, Normal, or High.
Is All Day
boolean
Set to true if the event lasts all day.
Is Reminder On
boolean
Set to true if the event has a reminder.
Reminder Start Duration
integer
Time in minutes before event start to remind.
Show As
string
Status to show during the event.
Response Requested
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.

Required Parameters

Group Id
guid
Pick a group from the drop down or enter group id.

Returns

List my owned groups

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

Required Parameters

Group Id
guid
Pick a group from the drop down or enter group id.
User's Email
string
A user's fully qualified email address (ex. user@microsoft.com).

Returns

Remove member from group

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

Required Parameters

Group Id
guid
Pick a group from the drop down or enter group id.
User's Email
string
A user's fully qualified email address. (ex. user@microsoft.com).

Triggers

When a group member is added or removed

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

Required Parameters

Group Id
guid
Pick a group from the drop down or enter group id.

Returns

User Id
string
Unique id of the user.
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.

Required Parameters

Group Id
guid
Pick a group from the drop down or enter group id.

Returns

Id
string
Unique id of the event.
Reminder Start Duration
integer
The number of minutes before the start of the event the reminder will fire.
Is Reminder On
boolean
Set to true if the event has a reminder.
Subject
string
Title of the event.
Importance
string
The importance of the event: Low, Normal, or High.
Is All Day
boolean
Set to true if the event lasts all day.
Response Requested
boolean
Set to true if the sender would like a response when the event is accepted or declined.
Show As
string
Status to show during the event.
Content Type
string
Body of the message associated with the event.
Content
string
Pick the content type: Text or Html.
Date Time
date-time
Start time of the event (example: '2016-11-01T14:30:00-07:00').
Time Zone
string
Time zone of the event, specified as a time zone index value (example: 'Pacific Standard Time').
Date Time
date-time
End time of the event (example: '2016-11-01T15:30:00-07:00').
Time Zone
string
Time zone of the event, specified as a time zone index value (example: 'Pacific Standard Time').
Name
string
The display name for the location of the event.

Definitions

ListGroupMembers_Response

Display Name
string
User's display name.
Given Name
string
User's first name.
Job Title
string
User's job title.
Mail
string
User's email address.
Mobile Phone
string
User's mobile number.
Office Location
string
User's office address.
Surname
string
User's last name.
User Id
string
Unique id of the user.
User Principal Name
string
UPN id of the user.
value
array of object
value

ListOwnedGroups_Response

Classification
string
O365 group classification.
Created Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Deleted Date-Time
string
yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Description
string
More information about the group.
Email
string
Email address of the group.
Group Id
string
Unique identifier of the group.
Mail Enabled
boolean
True if mail is enabled for the group.
Name
string
O365 group name.
Nickname
string
Group nickname.
On-Premises Last Sync Date-Time
string
yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
On-Premises Security Identifier
string
The on-premises security identifier.
On-Premises Sync Enabled
string
True if on-premises sync is enabled for the group.
Renewed Date-Time
date-time
yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Security Enabled
boolean
True if the owner is security enabled.
Visibility
string
The owner's visibility.
value
array of object
value

CreateCalendarEvent_Response

Content
string
The content of the body of this event.
Content Type
string
Text or Html.
Date Time
date-time
Start time of the event (example: '2016-11-01T14:30:00-07:00').
Date Time
date-time
End time of the event (example: '2016-11-01T15:30:00-07:00').
Id
string
Unique id of the event.
Importance
string
The importance of the event: Low, Normal, or High.
Is All Day
boolean
True if the event is an all day event.
Is Reminder On
boolean
Set to true if the event has a reminder.
Name
string
The display name for the location of the event.
Reminder Start Duration
integer
Time in minutes before event starts to remind.
Response Requested
boolean
True if a response was requested for the event.
Show As
string
Status to show during the event.
Subject
string
Title of the event.
Time Zone
string
Time zone of the event, specified as a time zone index value (example: 'Pacific Standard Time').
Time Zone
string
Time zone of the event, specified as a time zone index value (example: 'Pacific Standard Time').