# 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="/files/BoONCoaigqc5hbiJpMuk" 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](/user-and-organization-management/single-sign-on.md) 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](/user-and-organization-management/single-sign-on/azure-ad.md) or [Okta SAML](/user-and-organization-management/single-sign-on/okta-saml.md), 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](/user-and-organization-management/single-sign-on/azure-ad.md) or [Okta SAML](/user-and-organization-management/single-sign-on/okta-saml.md) 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](/getting-started.md) 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](/user-and-organization-management/getting-started/create-teams.md) — Organize users by department or project
* [Azure AD SSO](/user-and-organization-management/single-sign-on/azure-ad.md) — Automate user provisioning
* [Team Quotas](/user-and-organization-management/environments-and-access-control/team-quotas.md) — Control resource access per team
* [FAQ](/user-and-organization-management/getting-started/faq.md) — Common questions about user management


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.valohai.com/user-and-organization-management/getting-started/invite-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.