Add and manage organizations

All Kinde businesses come with one default organization. Some businesses will create more organizations to support a multi-tenancy business model. Learn more about organizations.

• To add organizations manually, follow the procedure below.
• To add multiple organizations, we recommend importing them. See Import organizations.
• You can also add and manage organizations via API.

Add an organization

Link to this section

1. In the main menu, select Organizations. The Organizations page opens.
2. Select Add organization.
3. Enter the name of the organization.
4. If you want, add an External organization ID. This is the ID you use to identify the organization, and enables you to import users and assign them to organizations by matching to this ID.
5. Select Save. The organization now appears on the Organization page, and is assigned a unique code. Developers need this code for using the Kinde API and SDKs.
6. To view the details or get the code again, select the three dots and then select View details.

Change the name of the default organization

Link to this section

When you first sign up to Kinde, you have one organization already created for you. This is the default organization that all users will be added to, until you create other organizations.

You can change the name of this organization, but not the unique code.

1. In the main menu, select Organizations. The Organizations page opens.
2. Select the three dots next to the default organization, and select View details.
3. Edit the organization name and select Save.

Suspend an organization

Link to this section

Admins can temporarily suspend an organization to prevent all users from logging in. When an organization is suspended:

• All active sessions for users in that organization are ended
• All refresh tokens and access tokens scoped to the organization are revoked
• Users attempting to log in to the organization will see an error
• A red Suspended badge appears next to the organization name in the organization list and user detail pages
• A warning banner appears on the organization details page reading “This organization is suspended. Users cannot log in to this organization.”

The default organization cannot be suspended.

To suspend an organization

Link to this section

1. Go to Organizations and select the organization
2. Scroll down to the Organization status section
3. Select Suspend organization
4. Confirm in the dialog

To unsuspend an organization

Link to this section

1. Go to the suspended organization’s details page
2. In the Organization status section, select Unsuspend organization
3. Confirm in the dialog — users will be able to log in again

Suspend an organization via the Management API

Link to this section

This feature can also be managed via the Kinde Management API using the PATCH /api/v1/organization/{org_code} endpoint with the is_suspended field.