What is Multi-Organization?
Multi-Organization is a feature that allows users to belong to multiple organizations using the same email address. This enables seamless switching between organizations without requiring separate login credentials. Key Benefits:- Single email address across multiple organizations
- Seamless switching between organizations from your profile
- Create new organizations without logging out
- Password synchronization across all organizations
How It Works
- Login - User logs in normally with their email and password
- Auto-Selection - System automatically logs user into their most recently accessed organization
- View Organizations - User can view all their organizations from the profile menu
- Switch - User can switch to any organization they belong to
- Create New - User can create additional organizations (if permitted)
When you switch organizations, your current session token is revoked and a new token is issued for the target organization. Make sure to update your stored token after switching.
API Endpoints
Get User Organizations
GET /auth/my-organizations
Switch Organization
POST /auth/switch-organization
Create Organization
POST /auth/create-organization
Copy Data Feature
When creating a new organization, you can optionally copy data from your first organization where you have the owner role (either as the original creator or as an invited owner).What Gets Copied
| Data | Copied | Notes |
|---|---|---|
| Organization Settings | ✅ | Language, currency, configuration |
| Hubs | ✅ | All hubs you have access to |
| Custom Roles | ✅ | Only with system permissions |
| Flows | ✅ | All custom and default flows |
| Default Roles | ❌ | Always created from standard templates |
| Custom Module Permissions | ❌ | Organization-specific, not transferable |
Important Notes
- Default roles (Owner, Admin, Planner, Field User) are always created from standard templates with their default permissions
- Custom roles are copied but only retain system permissions - any custom module permissions are excluded
- Invited owners can also use the copy feature - you don’t need to be the original organization creator
Password Behavior
When a user belongs to multiple organizations:- Password Sync: Password changes are synchronized across all organizations automatically
- Password Reset: Admin can only reset passwords for users who originally registered in their organization (not for invited users)
Permissions
| Permission | Description |
|---|---|
create/organization | Required to create new organizations |