Update Group

Update an Office 365 group.

Input

Field Definition Type Required
Group
Id 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 Optional. Description for the group. String FALSE
Display Name 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 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. 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 Result of the operation. The HTTP status code is returned by the connector and indicates whether the action taken by the card succeeded or failed. For example:
  • A 201 Created status code indicates success where a new resource was created.
  • A 403 Forbidden error indicates that the HTTP request was not processed because the necessary permissions were missing.

For a full list of possible status codes, see HTTP status codes.

Number

Related topics

Office 365 Admin connector

About the elements of Okta Workflows

Office 365 Admin Management API overview