# Create group

Create a user group for an account (tenant).

Provide the group details in the request body.

Endpoint: POST /resources/groups/v1
Security: bearer

## Header parameters:

  - `frontegg-tenant-id` (string)
    The tenant identifier. Required for requests to api.frontegg.com (or your region) when using a management token. Parsed from the token when using user or API tokens

## Request fields (application/json):

  - `color` (string)
    Color for group display

  - `description` (string)
    Group description

  - `metadata` (string)
    Stringified JSON object
    Example: "{}"

  - `name` (string, required)
    Group unique name

## Response 201 fields (application/json):

  - `id` (string, required)

  - `name` (string, required)

  - `color` (string, required)

  - `description` (string, required)

  - `metadata` (string, required)

  - `roles` (array, required)

  - `roles.vendorId` (string, required)

  - `roles.tenantId` (string, required)

  - `roles.key` (string, required)

  - `roles.isDefault` (boolean, required)

  - `roles.firstUserRole` (boolean, required)

  - `roles.level` (number, required)

  - `roles.createdAt` (string, required)

  - `roles.updatedAt` (string, required)

  - `users` (array, required)

  - `users.email` (string, required)

  - `users.profilePictureUrl` (string, required)

  - `users.activatedForTenant` (boolean, required)

  - `managedBy` (string, required)
    Enum: "frontegg", "scim2"