Update Group

Update an Office 365 group.

Input

Field Definition Type Required
Group
Id The unique identifier for the group. String TRUE
Properties
Allow External Senders

Indicates if people external to the organization can send messages to the group. Default value is false.

Important Note

This field must be updated individually - cannot update other fields in conjunction with Allow External Senders. The error message: The request is currently not supported on the targeted entity set is indicative of this behavior.

Boolean FALSE
Auto Subscribe New Members

Indicates if new members added to the group will be auto-subscribed to receive email notifications. You can set this property in a PATCH request for the group; do not set it in the initial POST request that creates the group. Default value is false.

Important Note

This field must be updated individually - cannot update other fields in conjunction with Auto Subscribe New Members. The error message: The request is currently not supported on the targeted entity set is indicative of this behavior.

Boolean FALSE
Description An optional description for the group. String FALSE
Display Name The display name for the group. This property is required when a group is created and cannot be cleared during updates. String FALSE
Mail Enabled true: the group is mail-enabled. false: the group is not mail-enabled. Boolean FALSE
Mail Nickname

The mail alias for the group, unique in the organization. This property must be specified when a group is created.

Note

This field must not contain a space.

String FALSE
Security Enabled Specifies whether the group has security enabled. Only Office 365 groups can create/update this property. Boolean FALSE
Visibility Specifies the visibility of an Office 365 group. See group visibility options to learn more. Dropdown FALSE
Public Anyone can join the group without needing owner permission. Anyone can view the contents of the group. String FALSE
Private Owner permission is needed to join the group. Non-members cannot view the contents of the group. String FALSE
Hiddenmembership Owner permission is needed to join the group. Non-members cannot view the contents of the group. Non-members cannot see the members of the group. Administrators (global, company, user, and helpdesk) can view the membership of the group. The group appears in the global address book (GAL). String FALSE

Output

Field Definition Type
Status Code The status code returned by the API. A value of 204 indicates the user was updated successfully. Number

Related topics

Office 365 Admin connector

About the elements of Okta Workflows

Office 365 Admin Management APIs overview