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​

You need the Super Admin (admin) or Business Admin (business_admin) tenant role to create organizations and suborganizations.

  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 administrator in the Create new Organization Admin step (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.

    Send Invite creates the user in the organization user population, grants them the Organization Admin (manager) role, and sends them an activation email.

    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 copy the configuration of a template organization, including its user populations, sign-in methods, identity providers, applications, and policies. Users and administrators are not copied, and later changes to the template don't affect organizations already created from it.

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

Learn more: Organization templates.

Organization administrator creation​

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

  • Send Invite – Creates the user with the Organization Admin (manager) role and sends an activation email. The administrator follows the link to set up their credentials.
  • Skip – Creates the organization without an administrator. You can add administrators later.

Step 2 appears only when the new organization has exactly one user population. If the template gives it no user population or more than one, add administrators afterwards. To add more administrators or change their roles, see Organization administrator roles and permissions.

See also​