Create Group

Create an Office 365 group.

Options

Field	Definition	Type	Required
Group Type	The type of group to create: Office 365 Group: Create an Office 365 unified group. Security Group: Create a security group.	Dropdown	TRUE

Field

Definition

Type

Required

Group Type

The type of group to create:

Office 365 Group: Create an Office 365 unified group.
Security Group: Create a security group.

Dropdown

TRUE

Input

Field	Definition	Type	Required
Group
Description	Optional. Description for the group.	Text	FALSE
Display Name	Display name for the group. This property is required when a group is created and can't be cleared during updates.	Text	TRUE
Mail Nickname	Mail alias for the group, unique in the organization. This property must be specified when a group is created. This field can't contain a space.	Text	TRUE
Members	Users and groups that are members of this group. This field accepts a list of user or group IDs.	List of Text	FALSE
Owners	Owners of the group. The owners are a set of non-admin users who are allowed to modify this object. Limited to 10 owners. This field accepts a list of user IDs.	List of Text	FALSE
Preferred Data Location	Preferred data location for the group. For more information, see OneDrive Online Multi-Geo. This property can only be set on create or update actions for Office 365 groups. This property can't be set for Security groups.	Text	FALSE
Security Enabled	Specifies whether the group has security enabled. Only Office 365 groups can create and update this property.	True/False	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.	Text	FALSE
Private	Owner permission is needed to join the group. Non-members can't view the contents of the group.	Text	FALSE
Hiddenmembership	Owner permission is needed to join the group. Non-members can't view the contents of the group. Non-members can't see the members of the group. Administrators (global, company, user, and help desk) can view the membership of the group. The group appears in the global address book (GAL).	Text	FALSE

Output

Field	Definition	Type
Group
Classification	Describes a classification for the group (such as low, medium, or high business impact). Valid values for this property are defined by creating a ClassificationList setting value, based on the groupSettingTemplate definition. See groupSetting and groupSettingTemplate resource types.	Text
Created Date Time	Timestamp of when the group was created. The value can't be modified and is automatically populated when the group is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `2014-01-01T00:00:00Z`.	Text
Description	Optional. Description for the group.	Text
Display Name	Display name for the group. This property is required when a group is created and can't be cleared during updates.	Text
Group Types	If the collection contains `Unified` then the group is an Office 365 group. Otherwise it's a security group. `["Unified"]` - Office 365 group. `[]` - Security group.	List of Text
Id	Unique identifier for the group.	Text
Mail	SMTP address for the group. For example, `serviceadmins@contoso.onmicrosoft.com`.	Text
Mail Enabled	Specifies whether the group is mail-enabled.	True/False
Mail Nickname	Mail alias for the group, unique in the organization.	Text
On Premises Last Sync Date Time	Indicates the last time at which the group was synced with the on-premises directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `2014-01-01T00:00:00Z`.	Text
On Premises Provisioning Errors	Errors when using Microsoft synchronization product during provisioning.	List of Objects
On Premises Security Identifier	Contains the on-premises security identifier (SID) for the group that was synchronized from on-premises to the cloud.	Text
On Premises Sync Enabled	`true` if this group is synced from an on-premises directory `false` if this group was originally synced from an on-premises directory but is no longer synced `null` if this object has never been synced from an on-premises directory (default).	True/False
Preferred Data Location	Preferred data location for the group. For more information, see OneDrive Online Multi-Geo.	Text
Proxy Addresses	Email addresses for the group that direct to the same group mailbox. For example: `["SMTP: bob@contoso.com", "smtp: bob@sales.contoso.com"]`. The any operator is required to filter expressions on multi-valued properties.	List of Text
Renewed Date Time	Timestamp of when the group was last renewed. This can't be modified directly and is only updated through the renew service action. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `2014-01-01T00:00:00Z`.	Text
Resource Behavior Options	List of options enumerating related resources' behavior for the group.	List of Text
Resource Provisioning Options	List of options enumerating provisioning options for the group.	List of Text
Security Enabled	Specifies whether the group has security enabled.	True/False
Security Identifier	Security identifier of the group, used in Windows scenarios.	Text
Visibility	Specifies the visibility of an Office 365 group. See group visibility options. Visibility can be set only when a group is created. It isn't editable. Visibility is supported only for unified groups. It isn't supported for security groups.	Text
Public	Anyone can join the group without needing owner permission. Anyone can view the contents of the group.	Text
Private	Owner permission is needed to join the group. Non-members can't view the contents of the group.	Text
Hiddenmembership	Owner permission is needed to join the group. Non-members can't view the contents of the group. Non-members can't see the members of the group. Administrators (global, company, user, and help desk) can view the membership of the group. The group appears in the global address book (GAL).	Text

Create Group

Options

Input

Output

Related topics