Skip to content

Organizations / Shared Accounts

Organizations are groups of your users that will use your product together. These are also referred to as companies, tenants, teams, workspaces, or shared accounts. Let's say you are building a product that helps people create and share documents internally. Your customers might include:

  • A two-person startup
  • A fast-growing 50-person tech company
  • A hobbyist using you by themselves, but who might get more employees someday
  • A large enterprise

Each of these would be an organization within your product, managed by PropelAuth.

How are orgs created?

There are three ways to create an organization.

  1. Your end users can create them themselves. Just like the signup and login pages, PropelAuth provides a UI for your end users to create these organizations. Our frontend libraries provide functions for you to redirect your users to the "create org" page and to get which orgs the user is a member of.
configurable page for creating organizations
A configurable UI your users use to create organizations
  1. You can use the PropelAuth dashboard to create organizations for your users.
  2. You can use our APIs to create organizations programmatically.

How do users get added to orgs?

PropelAuth provides a management UI for your users as well. This enables them to send invitations, manage roles, remove users from the organization, and more.

org management page

A user that received an invitation will be prompted to sign up if they haven't yet. Afterwards, they can accept or decline the invitation.

user invitation

Your users can also allow anyone with a matching email domain to automatically join at the lowest role (e.g. everyone from @acme.com can join the Acme Organization).

We also support SAML which enables your customers to connect their organization membership directly to their identity provider (like Okta, OneLogin, or JumpCloud).

Can users be in multiple orgs?

Yes, users can create and join multiple organizations.