# Invite Users

Add team members to your organization by sending email invitations. Invited users can access shared projects, environments, and data stores based on their team membership and permissions.

## Send an Invitation

1. Navigate to **Hi, \<name>** in the top-right menu
2. Select **Manage \<organization>**
3. Open the **Invitations** tab
4. Enter the user's email address
5. (Optional) Assign them to teams
6. (Optional) Grant admin privileges
7. Click **Send Invitation**

<figure><img src="https://4109720758-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff3mjTRQNkASbnMbJqzJ2%2Fuploads%2Fgit-blob-d211c3c4acca700d7404c720aeaaa97a09d8cbd0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

The recipient receives an email with a link to join your organization. If they don't have a Valohai account, they'll create one during the invitation flow.

## Team Assignment

Assign users to teams during invitation to grant immediate access to team-owned projects and resources:

**No teams:** User has access only to their personal projects and organization-shared resources.

**One or more teams:** User inherits permissions from all assigned teams, including:

* Access to team-owned projects
* Shared environment quotas
* Team-specific data stores

You can modify team membership later in the **Members** tab.

## Admin Privileges

Admin users can:

* Invite and remove users
* Create and manage teams
* Configure environments and scaling rules
* Manage organization settings and billing
* Access all projects in the organization

> Grant admin access carefully. Admins have full control over the organization, including the ability to delete projects and modify security settings.

## Multiple Invitations

Send invitations to multiple users at once by repeating the process. Each user receives a separate invitation email.

For bulk user provisioning, consider setting up [Single Sign-On](https://docs.valohai.com/user-and-organization-management/single-sign-on) to automate user management.

## Manage Existing Users

After users join, manage them in the **Members** tab:

**Promote to admin:**

1. Go to **Members** tab
2. Find the user
3. Click the admin toggle
4. Confirm the change

**Modify team membership:**

1. Click the user's name
2. Add or remove teams
3. Save changes

**Remove user:**

1. Find the user in **Members**
2. Click remove
3. Confirm removal

Removed users lose access to organization projects and resources immediately.

## Invitation Status

Track pending invitations in the **Invitations** tab:

**Pending:** Email sent, user hasn't accepted yet. Resend if needed.

**Accepted:** User joined the organization. They now appear in the **Members** tab.

**Expired:** Invitation link expired (typically after 7 days). Send a new invitation.

## SSO Users

If your organization uses [Azure AD](https://docs.valohai.com/user-and-organization-management/single-sign-on/azure-ad) or [Okta SAML](https://docs.valohai.com/user-and-organization-management/single-sign-on/okta-saml), users may be added automatically based on your SSO configuration.

**Automatic provisioning:** Users who log in via SSO are automatically added to your organization if they match your access grants.

**Team mapping:** Configure SSO to automatically assign users to teams based on their SSO group membership.

**Manual invitations still work:** You can still send email invitations to SSO users. They'll be prompted to use SSO login when accepting.

See [Azure AD](https://docs.valohai.com/user-and-organization-management/single-sign-on/azure-ad) or [Okta SAML](https://docs.valohai.com/user-and-organization-management/single-sign-on/okta-saml) setup guides for automatic team mapping configuration.

## New User Onboarding

After users join, guide them to:

1. **Complete their profile:** Set up two-factor authentication if required
2. **Generate API tokens:** For CLI and programmatic access
3. **Join relevant projects:** As collaborators or through team ownership
4. **Review documentation:** Share [Getting Started](https://docs.valohai.com/getting-started) guides

## Invitation Best Practices

**Assign teams during invitation:** Saves time compared to adding users to teams separately.

**Set expectations:** Let users know which teams they're joining and what projects they'll access.

**Use admin sparingly:** Grant admin only to users who need full organizational control.

**Track invitations:** Check the **Invitations** tab periodically to follow up on pending invitations.

**Clean up expired invitations:** Remove old pending invitations and resend if needed.

## Related Topics

* [Create Teams](https://docs.valohai.com/user-and-organization-management/getting-started/create-teams) — Organize users by department or project
* [Azure AD SSO](https://docs.valohai.com/user-and-organization-management/single-sign-on/azure-ad) — Automate user provisioning
* [Team Quotas](https://docs.valohai.com/user-and-organization-management/environments-and-access-control/team-quotas) — Control resource access per team
* [FAQ](https://docs.valohai.com/user-and-organization-management/getting-started/faq) — Common questions about user management