Enterprise user management

Enterprise and uses: Insomnia

Insomnia teams

You can use teams to manage access for multiple users. You can add users to a team, and the team can then be assigned to organizations.

Let’s say that you have an engineering organization and a product organization. You could create:

  • An admin team which has access to all organizations
  • A dev team which has access to the engineering organization only
  • A product team which has access to the product organization only

This would allow you to automatically add users to the relevant organizations by adding them to a team.

Teams are managed in Enterprise Controls > Teams. You can create new teams, invite users to teams, and assign organizations to teams.

You can also manage teams using SCIM provisioning. For more information, see SCIM.

Notes:

  • Roles are defined on the team level, which means that if the same team is linked to multiple organizations, the team members will have the same role in all linked organizations.
  • Teams can’t be renamed or deleted manually in Insomnia, but this feature will be added in a future release. However, teams deleted through SCIM will also be deleted in Insomnia.

Domain capture

Use domain capture to automatically add new users to your Insomnia Enterprise account when they sign up with a verified email domain. To enable domain capture and auto-capture all new employees:

  1. Add and verify a domain.
  2. In the domain settings, click the toggle to enable domain capture.

You can enable domain capture on a verified domain only.

When you enable domain capture on a verified domain, all new users that create an Insomnia account with an email address in the domain are automatically added to the Enterprise account. For example:

  • Kong uses @kong.com and enables domain capture: When Amal@kong.com signs up for Insomnia, the platform automatically adds Amal@kong.com to the Enterprise license and lists the user on the licenses page.

If you add a new user to your Insomnia Enterprise account with no license seats left in your Enterprise plan, then the new user won’t be able to create an account with that domain. To increase the number of seats that you have access to, update your subscription.

Insomnia licenses

The Licenses tab in your Enterprise settings allows you to manage who can access Enterprise resources.

From this tab, you can also remove users from your Enterprise account. These users will still be able to log in, but they will not have access to Enterprise data and their seat will be freed.

User activity reports

You can generate a CSV report about active and inactive users by clicking the download button next to Last Active in the Licenses page. This report contains the date at which each user last opened Insomnia.

This data is maintained for 90 days. After 90 days without any activity, the date no longer appears in the report but the user will always be listed. If a user was last active more than 100 days before the report was generated, the Last Active value for that user will be N/A in the report. This allows you to quickly find inactive users.

For any user who last logged in before May 20, 2025, the date will show their last login date.

FAQs

Removing a user from an organization is not enough to free their seat, you need to remove the user from the Licenses page.

Something wrong?

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!