Skip to content

Function: createGroup() ​

ts
function createGroup(
   client, 
   parameters, 
   options?
): Promise<{
[key: string]: unknown;
  displayName?: string;
  externalId?: string;
  id?: string;
  members?: object[];
  meta?: {
   [key: string]: unknown;
     created?: Date;
     lastModified?: Date;
     location?: string;
     resourceType?: string & object | "USER" | "GROUP" | "DIRECTORY";
  };
  schemas?: string[];
}>;

Defined in: src/userProvisioning/api/groups.ts:198

Creates a read-only group in the organization's directory. You can only edit groups from your identity provider.

Note: An attempt to create a group with an existing name will fail with a 409 (Conflict) error.

Parameters ​

ParameterTypeDescription
clientClient-
parameters{ directoryId: string; displayName?: string; externalId?: string; id?: string; members?: object[]; meta?: { created?: unknown; lastModified?: unknown; location?: string; resourceType?: string & object | "USER" | "GROUP" | "DIRECTORY"; }; schemas?: string[]; }-
parameters.directoryIdstringThe SCIM base URL that is generated when conecting an identity provider with SCIM provisioning.
parameters.displayName?stringGroup display name. This is a immutable, required, and read-only field.
parameters.externalId?stringIdentifier defined by provisioning client. CaseExact. Uniqueness is controlled by client.
parameters.id?stringUnique identifier defined by Atlassian SCIM Service. This is a read-only and case-sensitive field. It is ignored if specified in the payload during user creation or modification.
parameters.members?object[]Group members
parameters.meta?{ created?: unknown; lastModified?: unknown; location?: string; resourceType?: string & object | "USER" | "GROUP" | "DIRECTORY"; }-
parameters.meta.created?unknownThe DateTime that the resource was added to Atlassian SCIM service. This is a read-only field.
parameters.meta.lastModified?unknownThe most recent DateTime that the details of this resource were updated. This is a read-only field.
parameters.meta.location?stringThe URI of the resource being returned. This is a read-only field.
parameters.meta.resourceType?string & object | "USER" | "GROUP" | "DIRECTORY"The name of the resource type of the resource. This is a read-only and case-sensitive field.
parameters.schemas?string[]SCIM schemas that define the attributes present in the current JSON structure. This ia a required field during user creation or modification.
options?RequestOptions-

Returns ​

Promise<{ [key: string]: unknown; displayName?: string; externalId?: string; id?: string; members?: object[]; meta?: { [key: string]: unknown; created?: Date; lastModified?: Date; location?: string; resourceType?: string & object | "USER" | "GROUP" | "DIRECTORY"; }; schemas?: string[]; }>