Latest Content

How to Add a User to a Group

Updated on 08 April, 2026

Add a user to an IAM group on Vultr. The user inherits all roles and policies attached to the group through the Vultr API or Console upon being added.

Adding a user to a group grants them all roles and policies assigned to that group. This simplifies access management by allowing you to control permissions at the group level rather than assigning them to individual users.

Note
You must be the organization's root user or have iam.group.* permissions assigned to perform this action.

This guide explains how to add a user to 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 Users tab.

  5. Click the name of the user you want to add to a group.

  6. In the Groups section, click the + icon.

  7. In the Add to Groups panel, select the groups you want to add the user to.

  8. Click Add User to Groups.

    The user is added to the selected groups and inherits their permissions.

  1. Send a GET request to the List Groups endpoint to retrieve all groups in your organization.

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

    Note the id of the group to which you want to add the user.

  2. Identify the id and display_name of the user you want to add. Follow the steps in How to List All Users in an Organization to retrieve user details.

  3. Send a POST request to the Create Group Member endpoint to add the user to the group. Replace {group-id} with the group id, USER-ID with the user's unique identifier, and USER-DISPLAY-NAME with the user's display name.

    console 
    $ curl "https://api.vultr.com/v2/groups/{group-id}/members" \
    -X POST \
    -H "Authorization: Bearer ${VULTR_API_KEY}" \
    -H "Content-Type: application/json" \
    -d '{
        "id": "USER-ID",
        "display_name": "USER-DISPLAY-NAME"
    }'

    A successful request returns an HTTP 201 Created response.

  4. Send a GET request to the List Group Members endpoint to retrieve the group members.

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

    Verify that the user appears in the group members list.

Comments