> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro workspace user add

<Info>The behavior and format of this command differs depending on which Astronomer product you're using. Use the following tabs to change product contexts.</Info>

<Tabs>
  <Tab title="Astro">
    Add an existing Organization user to your current Astronomer Workspace. You must be a Workspace Owner to perform this action.

    You can use this command to invite multiple users to a Workspace at a time. See [Add a group of users to Astro using the Astro CLI](/docs/astro/manage-organization-users#add-a-group-of-users-to-astro-using-the-astro-cli).

    ## Usage

    ```sh wrap theme={null}
    astro workspace user add <email>
    ```

    ## Options

    | Option            | Description                                                          | Valid Values                                                                                                                         |
    | ----------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
    | `<email-address>` | The email address of the user that you want to add to the Workspace. | Any valid email address                                                                                                              |
    | `--role`          | The user's role in the Workspace.                                    | Possible values are either `WORKSPACE_ACCESSOR`, `WORKSPACE_MEMBER`, `WORKSPACE_AUTHOR`, `WORKSPACE_OPERATOR`, or `WORKSPACE_OWNER`. |

    ## Related commands

    * [`astro workspace user update`](/docs/cli/v1.38/astro-workspace-user-update)
    * [`astro organization user invite`](/docs/cli/v1.38/astro-organization-user-invite)
    * [`astro organization user update`](/docs/cli/v1.38/astro-organization-user-update)
  </Tab>

  <Tab title="APC">
    Creates a new user in your current Workspace. If the user has already authenticated to Astronomer, they will automatically be granted access to the Workspace. If the user does not have an account on Astronomer, they will receive an email invitation to the platform.

    ## Usage

    ```sh wrap theme={null}
    astro workspace user add --email <user-email-address>
    ```

    ## Options

    | Option                 | Description                                                                                                                                           | Possible Values                                                                                                           |
    | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
    | `--email` (*Required*) | The user's email                                                                                                                                      | Any valid email address                                                                                                   |
    | `--workspace-id`       | The Workspace that the user is added to. Specify this flag if you want to create a user in a Workspace that is different than your current Workspace. | Any valid Workspace ID                                                                                                    |
    | `--role`               | The role assigned to the user.                                                                                                                        | Possible values are `WORKSPACE_MEMBER`, `WORKSPACE_OPERATOR`, and `WORKSPACE_OWNER`. Default value is `WORKSPACE_MEMBER`. |

    ## Related documentation

    * [Manage Workspaces and Deployments on Astronomer](/docs/astro-private-cloud/v-0-37/manage-workspaces)
    * [Manage User Permissions on Astronomer](/docs/astro-private-cloud/v-0-37/workspace-permissions)
  </Tab>
</Tabs>