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

# forest users:invite

> Invite one or more users to a Forest project

# forest users:invite

Invite users to a project, with a permission level, a team and a role.

## Usage

```bash theme={null}
forest users:invite --email <EMAIL> --permission-level <LEVEL> [options]
```

## Options

| Option | Description |
| - | - |
| `-e, --email` | Email of the user to invite (required). Repeat the option to invite several users |
| `-l, --permission-level` | Permission level of the invited users (required): `admin`, `developer`, `editor`, `manager` or `user` |
| `-t, --team` | Name of the team to add the users to. Prompted when omitted and the project has several teams |
| `-r, --role` | Name of the role to assign. Prompted when omitted and the project has several roles |
| `-p, --projectId` | The ID of the project to work on |
| `-f, --format` | Output format: `table` (default) or `json` |

> [!NOTE]
>
> A project gets its first role when its production environment is created. Until then, `users:invite` has no role to assign and stops with an error.

## Examples

```bash theme={null}
# Invite one operator
forest users:invite --email jane@example.com --permission-level user --team Operations --role Support

# Invite several developers at once
forest users:invite -e alex@example.com -e sam@example.com -l developer -t Operations -r Admin
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.