---
title: How to Create a Group
url: https://docs.vultr.com/platform/iam/groups/how-to-create-a-group
description: Create a new IAM group in your Vultr organization. Groups let you organize users and assign shared roles and policies for centralized access management.
publish_date: 2026-03-24T19:52:16.129446Z
last_updated: 2026-06-01T20:39:49.880772Z
---

Groups in Vultr's IAM system allow you to organize users into logical collections for streamlined access management. Instead of assigning roles and policies to individual users, you can assign them to a group and all members automatically inherit the group's permissions.

> [!NOTE]
> You must be the organization's root user or have `iam.group.*` permissions assigned to perform this action.

Follow this guide to create a group using the Vultr Console, the Vultr API, or Terraform.

=== "Vultr Console"

    1. Log in to the [Vultr Console](https://console.vultr.com).
    1. Click the organization name in the top navigation bar.
    1. Click **Manage Organization**.
    1. Click the **Groups** tab.
    1. Click the **+** button to add a group.
    1. Enter the **Group Name** and **Group Description**.
    1. (Optional) Select **Members** and **Roles** to assign to the group.
    1. Click **Review**.
    1. Review the details and click **Add Group**.

        The group is created and appears in the **Groups** list.

=== "Vultr API"

    1. Send a `POST` request to the [**Create Group** endpoint](https://www.vultr.com/api/#tag/iam/operation/create-iam-group) to create a new group. Replace `GROUP-NAME` with a name for the group and `GROUP-DESCRIPTION` with a brief description of its purpose.

        ```console
        $ curl "https://api.vultr.com/v2/groups" \
            -X POST \
            -H "Authorization: Bearer ${VULTR_API_KEY}" \
            -H "Content-Type: application/json" \
            -d '{
                "display_name": "GROUP-NAME",
                "description": "GROUP-DESCRIPTION"
            }'
        ```

        A successful request returns an HTTP `201 Created` response with the group details. Note the `id` for future operations.

    1. Send a `GET` request to the [**Read Group** endpoint](https://www.vultr.com/api/#tag/iam/operation/get-iam-group) to retrieve the group details. Replace `{group-id}` with the id returned from the creation request. The response confirms the group details.

        ```console
        $ curl "https://api.vultr.com/v2/groups/{group-id}" \
            -X GET \
            -H "Authorization: Bearer ${VULTR_API_KEY}"
        ```

        The response contains the resource details.

=== "Terraform"

    1. Ensure the [Vultr Terraform provider](https://registry.terraform.io/providers/vultr/vultr/latest/docs) is configured in your Terraform project.

    1. Define the group resource. Replace `GROUP-NAME` and `GROUP-DESCRIPTION` with your values.

        ```hcl
        resource "vultr_organization_group" "my_group" {
          name        = "GROUP-NAME"
          description = "GROUP-DESCRIPTION"
        }
        ```

    1. Apply the configuration.

        ```console
        $ terraform apply
        ```

        Verify that the output shows `vultr_organization_group.my_group: Creation complete`. Note the group ID from the Terraform state for use in other resources.