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

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

Related topics

Azure Active Directory connector

Workflow elements

Guidance for Azure Active Directory connector

Azure Active Directory Management API overview