# Create a new group

Creates a new group and brings that group object to the service provider.


Endpoint: POST /scim/v2/Groups
Version: latest
Security: BearerAuth

## Request fields (application/json):

  - `schemas` (array, required)
    Example: ["urn:ietf:params:scim:schemas:core:2.0:Group"]

  - `id` (string)
    A unique identifier for a SCIM resource as defined by the service provider.

  - `externalId` (string)
    A String that is an identifier for the resource as defined by the provisioning client.

  - `displayName` (string, required)
    A human-readable name for the Group.
    Example: "Tour Guides"

  - `members` (array)
    A list of members of the Group.
    Example: [{"value":"92b725cd-9465-4e7d-8c16-01f8e146b87a","type":"User"}]

  - `members.value` (string)
    Value of an "id" attribute of a SCIM resource

  - `members.$ref` (any)
    The URI of a SCIM resource such as a "User", or a "Group"

## Response 201 fields (application/json):

  - `schemas` (array, required)
    Example: ["urn:ietf:params:scim:schemas:core:2.0:Group"]

  - `id` (string)
    A unique identifier for a SCIM resource as defined by the service provider.
    Example: "e9e30dba-f08f-4109-8486-d5c6a331660a"

  - `externalId` (string)
    A String that is an identifier for the resource as defined by the provisioning client.

  - `displayName` (string, required)
    A human-readable name for the Group.
    Example: "Tour Guides"

  - `members` (array)
    A list of members of the Group.
    Example: [{"value":"92b725cd-9465-4e7d-8c16-01f8e146b87a","ref":"https://example.com/v2/Users/92b725cd-9465-4e7d-8c16-01f8e146b87a","type":"User"}]

  - `members.value` (string)
    Value of an "id" attribute of a SCIM resource

  - `members.$ref` (any)
    The URI of a SCIM resource such as a "User", or a "Group"

  - `resourceType` (string)
    The name of the resource type of the resource.

  - `created` (string)
    The "DateTime" that the resource was added to the service provider.

  - `lastModified` (string)
    The most recent DateTime that the details of this resource were updated at the service provider.

  - `location` (string)
    The URI of the resource being returned.

  - `version` (string)
    The version of the resource being returned.