Latest Content

How to Create a Group

Updated on 08 April, 2026

Create a new IAM group in your Vultr organization. Groups let you organize users and assign shared roles and policies for centralized access management.

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.

This guide explains how to create a group using the Vultr Console or the Vultr API.

  • Vultr Console
  • Vultr API

  1. Log in to the Vultr Console.

  2. Click the organization name in the top navigation bar.

  3. Click Manage Organization.

  4. Click the Groups tab.

  5. Click the + button to add a group.

  6. Enter the Group Name and Group Description.

  7. (Optional) Select Members and Roles to assign to the group.

  8. Click Review.

  9. Review the details and click Add Group.

    The group is created and appears in the Groups list.

  1. Send a POST request to the Create Group endpoint 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.

  2. Send a GET request to the Read Group endpoint 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.

Comments