---
title: How to Add a User to a Group
url: https://docs.vultr.com/platform/iam/groups/how-to-add-a-user-to-a-group
description: 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.
publish_date: 2026-03-24T19:52:15.292260Z
last_updated: 2026-04-08T16:02:23.824231Z
---

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"

    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 **Users** tab.
    1. Click the name of the user you want to add to a group.
    1. In the **Groups** section, click the **+** icon.
    1. In the **Add to Groups** panel, select the groups you want to add the user to.
    1. Click **Add User to Groups**.

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

=== "Vultr API"

    1. Send a `GET` request to the [**List Groups** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-groups) 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.

    1. 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](https://docs.vultr.com/platform/iam/organizations/how-to-list-all-users-in-an-organization) to retrieve user details.

    1. Send a `POST` request to the [**Create Group Member** endpoint](https://www.vultr.com/api/#tag/iam/operation/add-iam-group-member) 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.

    1. Send a `GET` request to the [**List Group Members** endpoint](https://www.vultr.com/api/#tag/iam/operation/list-iam-group-members) 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.