Skip to main content

Create organizations and suborganizations

Set up organizations and suborganizations in SecureAuth to create isolated customer environments with delegated administration. Organizations let you represent multiple business customers within a single workspace while maintaining baseline security policies.

💡 Why this matters
Create isolated environments for each customer so they manage their own users while you maintain control over baseline security policies.

Business structure options​

Choose your organizational structure based on your business needs:

Structure TypeWhen to UseExample
Flat organizationsSimple customer separationEach customer = one organization
Parent-child hierarchyComplex business relationshipsHolding company with subsidiaries
Workspace groupingDepartmental separationHR, Finance, Operations workspaces

Create an organization​

  1. Go to Organizations and click Create Organization.

    Organizations page with create button

  2. Configure the organization details (Step 1/2 on the UI):

    Security note

    Organization IDs are permanent and used in API calls - choose descriptive, consistent naming conventions.

    SettingValueNotes
    Name[Business name]User-friendly display name
    Organization ID[unique-identifier]Cannot be changed after creation
    Email domains[company-domains]Enables intelligent identity provider discovery

    Create organization dialog - Step 1

  3. Click Create to continue to Step 2.

  4. Optionally create an organization admin (Step 2/2 on the UI):

    Create organization admin dialog - Step 2

    SettingValueNotes
    Email[admin-email]Admin user's email address
    First name[Admin first name]Administrator's first name
    Last name[Admin last name]Administrator's last name

  5. Choose Send Invite to create the admin user, or Skip to complete organization creation.

    Verify: New organization appears in the Organizations list with "Active" status

Create suborganizations​

Create suborganizations to represent departments, locations, or divisions within a parent organization.

  1. Go to the parent organization where you want to add a suborganization.

  2. Select Suborganizations > Create Organization.

  3. Configure the suborganization details (Step 1/2 on the UI):

    Security note

    Organization IDs are permanent and used in API calls - choose descriptive, consistent naming conventions.

    SettingValueNotes
    Name[Suborganization name]User-friendly display name
    Organization ID[unique-identifier]Cannot be changed after creation
    Email domains[company-domains]Enables intelligent identity provider discovery

  4. Click Create to continue.

  5. Optionally create an organization admin (same process as organization creation - Step 2/2 on the UI).

  6. Choose Send Invite or Skip to complete suborganization creation.

    Verify: Suborganization appears under the parent organization in the hierarchy view

Organization features​

Email domain intelligence​

When users enter email addresses during authentication, SecureAuth automatically displays authentication options for organizations with matching email domains.

Example: User with user@acmecorp.com sees ACME Corp's SSO options when acmecorp.com is configured for that organization.

Organization templates​

Use an organization template during creation to automatically copy configurations (authentication settings, policies, branding) from a template organization. This is useful when creating multiple similar organizations.

Use case: Create multiple similar organizations (like franchise locations) with consistent security policies.

Learn more: Create organization templates.

Organization administrator creation​

The optional Step 2 allows you to immediately create an administrator for the new organization:

  • Send Invite – Creates user account and sends email invitation to set password
  • Skip – Organization created without dedicated administrator (can be added later)

See also​