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

# Organizations

> Manage your team with organizations on the Enterprise plan

# Organizations

Organizations let you group team members, scope workflows, and manage settings in one place. They're available on the Enterprise plan for teams that need centralized control over their HITL.sh workflows.

## What Are Organizations?

An organization is a shared workspace where team members collaborate on review workflows. Organizations provide:

> [card] Centralized Management
>
> Manage all team members, workflows, and settings from a single dashboard

> [card] Org-Scoped Workflows
>
> Create workflows that belong to the organization rather than individual users

> [card] Role-Based Access
>
> Assign roles (owner, admin, member, viewer) to control who can do what

> [card] Humans Management
>
> Organize reviewers into a shared Universe with Groups and People across the organization

## Creating an Organization

**1. Open the Dashboard**

Navigate to [my.hitl.sh](https://my.hitl.sh) and sign in to your account.

**2. Create Organization**

Click the organization switcher in the sidebar and select **Create Organization**. Enter a name for your organization -- a URL-friendly slug will be generated automatically.

**3. Contact Us for Enterprise**

Organizations are available on the Enterprise plan. Contact [team@hitl.sh](mailto:team@hitl.sh) to set up Enterprise billing for your organization.

**4. Invite Members**

Once created, invite team members by email or share the organization's invite code.

## Organization Structure

### Members

Every organization has a list of members, each with an assigned role:

```json theme={null}
{
  "user_id": "64a1b2c3d4e5f6a7b8c9d0e1",
  "role": "admin",
  "joined_at": "2026-07-15T10:30:00Z"
}
```

See [Roles & Permissions](https://docs.hitl.sh/guides/roles-permissions.md) for details on the 4-tier role model.

### Humans Directory

Organizations have a shared Humans directory:

* **Universe**: The default group containing all people in the organization
* **Groups**: Create groups like "Content Moderators", "Legal Team", or "Senior Reviewers" and assign them to workflow human review nodes
* **People**: Invite individuals by email -- they join the organization and appear in the shared Universe

See [Humans](https://docs.hitl.sh/concepts/humans.md) for details on managing reviewers.

### Settings

Organization settings control enterprise features:

**escalation\_enabled** `boolean` (default: false)

When enabled, response requests can be escalated to higher-level reviewers when not resolved within a configurable timeframe.

**audit\_retention\_days** `integer` (default: 90)

Number of days to retain audit logs for organization activity. Enterprise plans can configure this value.

## Org-Scoped Workflows

Workflows created within an organization are scoped to that organization. This means:

* All organization members with appropriate roles can access the workflow
* Workflow executions respect the organization's settings
* Execution analytics roll up to the organization's dashboard
* The Humans directory is shared across all workflows in the organization

## Invite Codes

Organizations support invite codes that let new members join without requiring an individual email invitation.

### How Invite Codes Work

**1. Generate Code**

An owner or admin generates an invite code from the organization settings page.

**2. Share Code**

Share the invite code or link (e.g., `my.hitl.sh/org-invite/{code}`) with prospective members.

**3. Join Organization**

Recipients visit the invite link, sign in (or create an account), and are automatically added to the organization as a **member**.

### Deep Link Support

Invite links work across platforms:

* **Web:** Opens the join page directly at `my.hitl.sh/org-invite/{code}`
* **Mobile:** Deep links carry the invite code through the sign-in flow, so new users are added to the organization after completing registration

## Organization Switcher

If you belong to multiple organizations, the sidebar in the web dashboard includes an organization switcher. Switching organizations updates:

* The workflows visible in the sidebar
* The inbox filter to show only that organization's response requests
* The Humans directory to show that organization's groups and people
* The settings page to show that organization's configuration
* Analytics and usage data scoped to the selected organization

## Best Practices

> [accordion] Start with Clear Roles
>
> Assign roles intentionally from day one. Use **viewer** for stakeholders who need visibility, **member** for active reviewers, **admin** for team leads, and reserve **owner** for the account holder.

> [accordion] Use Org-Scoped Workflows
>
> Create workflows within the organization rather than under individual accounts. This ensures continuity if team members leave and keeps analytics centralized.

> [accordion] Organize Your Humans Directory
>
> Create purposeful groups in your Humans directory that map to review responsibilities. Assign these groups to human review nodes in your workflows for clear routing.

> [accordion] Use Invite Codes for Onboarding
>
> For teams with frequent turnover, use invite codes instead of individual email invitations. This simplifies onboarding and reduces admin overhead.

## Next Steps

> [card] [Roles & Permissions](https://docs.hitl.sh/guides/roles-permissions.md)
>
> Understand the 4-tier role model and what each role can do

> [card] [Humans](https://docs.hitl.sh/concepts/humans.md)
>
> Set up your Universe, Groups, and People for reviewer management

> [card] [Workflow Designer](https://docs.hitl.sh/guides/workflow-designer.md)
>
> Build workflows within your organization

> [card] [Dashboard](https://docs.hitl.sh/dashboard.md)
>
> Explore the web dashboard and organization switcher


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