Manage team members

Some team options are only available on Postman Professional and Enterprise plans.

As a Team Admin or Super Admin, you can invite collaborators, remove existing team members, and update user roles at any time in your team dashboard.

With the Billing role, you can also change your team's size to accommodate more collaborators at any time in your billing cycle.

Team dashboard

You can invite collaborators, remove existing team members, and update user permissions in your team dashboard. To open your team dashboard, select Team in the Postman header, then select Manage Team.

Invite users

You can invite people to join your team, enable coworkers who aren't part of your team to view and send requests in specific collections, and invite external partners to collaborate using Partner Workspaces.

Invite people to join your team

To invite team members, do the following:

1. In your team dashboard, select Invite People.

2. Enter the email addresses of the people you want to invite. Alternatively, you can select Add from file to upload a text or CSV file with the email addresses. You can also select Copy Invite Link to invite team members through link sharing.

3. Use Roles to assign these users one or more team roles.

4. Select Send Invite.

If you're on a Postman Enterprise plan, you can provision user accounts at scale through your identity provider (IdP) by setting up and using SCIM.

Users can also join using shared links by enabling manual or automatic approval. For more information, see Manage team access through shared resources.

Invite guests

You can invite coworkers who aren't part of your Postman team to view specific collections and send requests in those collections. To learn more, see Share collections with guest users in your organization.

Invite partners

Partners are available on Postman Professional and Enterprise plans.

You can invite external partners and collaborate with them using a Partner Workspace. To learn more, see Inviting collaborators to a Partner Workspace.

Manage invites

As a Team Admin or Super Admin, you can invite users and assign them one or more team roles.

If you're on a Postman Free, Basic, or Professional plan, team members with the Developer role can invite users as Developers automatically, without the need for approval by a Team Admin.

To review all invites that have been sent, go to your team dashboard and select the Invites and requests tab.

You can manage the following types of invites:

• Pending invites - To copy the invite link, select Copy invite link. To delete the invite, select Revoke invite. You can also select to Resend Invite.

  

• Requests to join your team - You can review requests to join your team. To respond to a request, select Approve or Deny.

  

• Suggestions - An invite sent by a team member who isn't a Team Admin or Developer becomes an invite suggestion that you or another Team Admin must review for approval.

  If you're on an Enterprise team, invites sent by Developers also become invite suggestions.

  To approve the suggestion and invite the user to your team, select Invite. To delete the invite, select Dismiss suggestion.

  

• Invite links - To review the invites your team has sent, in your team dashboard select Invite links from the left menu. The list provides information about which users generated links, when they were generated, when they expire, and their URL.

  

  To copy an active invite URL, hover over its row and select Copy link.

  To revoke an active invite, hover over its row and select Delete link.

Manage team roles

Each team member must have one or more team roles assigned to them, which will enable them to perform different actions within your team. Roles can be granted to team members individually, or to members of a group.

You can change a team member's roles at any time in the team dashboard.

Search for a specific user by typing their name or email address in the search field. You can also filter users by role type. Select the roles next to the user you'd like to update, then select the roles you'd like to assign or remove. Select Update Roles to confirm your changes.

Some team roles are only available on Postman Professional and Enterprise plans.

Teams can have two support accounts at no extra cost. Support accounts are team members with only Admin or Billing roles. Team members with a Super Admin or Developer role will consume a paid seat on your team.

To learn more about the team roles that you can assign as a Team Admin, see Team roles.

Manage workspace roles

Workspace roles control access to elements within a workspace. Roles can be assigned to an individual user or to a user group.

To change the role of users in a workspace, or to remove a user from a workspace, do the following:

1. Select Workspaces in the Postman header, and then select a workspace.

2. On the workspace's Overview tab, select Settings.

3. Select a different workspace Role for a user or group:

   • Admin - Can manage workspace resources and settings.
   • Editor - Can create and edit workspace resources.
   • Viewer - Can view, fork, and export workspace resources.
   • Remove from workspace - Removes the user from the workspace. (You can invite the user again in the future.)

Manage element-based roles

Team members with Admin access for the workspace or Editor access for an element in it can manage element-based roles assigned to team members. Learn more about roles you can assign at the element level.

1. Hover over the element in the sidebar.

2. Select View more actions next to its name.

3. Select Manage roles.

   

4. (Optional) Search for team members and user groups in the workspace to add to the element.

5. Select the role next to their name, then select a different role. You can also select Remove to remove a team member or user group from the element.

   If you're managing roles for a collection, you can learn more about setting merge checks.

   Team members inherit permissions from the workspace role they're assigned. Team members can be individually assigned a workspace role, and the user group they're a member of can be assigned a workspace role. For example, a team member assigned the Workspace Editor role and Collection Viewer role will have Editor access to all collections in the workspace.

   

6. Select Update Roles to save your changes.

You can also use the Postman VS Code extension to manage collection and environment roles assigned to team members.

Manage Super Admins

Super Admins are available on Postman Enterprise plans.

If your team doesn't have a Super Admin yet, a Team Admin can assign the role to anyone in the team. Once your team has at least one Super Admin, only a Super Admin can assign this role to another user.

Super Admins can assign the Super Admin role to a user in the team dashboard, while inviting a new team member, and to a group. If your team is using SCIM, a Super Admin must create the SCIM credentials in order for SCIM to change the membership of a group that's been assigned the Super Admin role.

Regular Team Admins can't remove Super Admins from a team or remove their Super Admin role assignment.

It's recommended that you create a service user, such as postman-admin@example.com, that isn't tied to any individual and assign that user the Super Admin role. By doing so, your team can avoid the risk of a disruption in services due to an actual user leaving your company. This ensures that your team's management is able to sign in to the service account when needed. Learn more about assigning the Super Admin role to a service account.

Manage partners

Partners are available on Postman Professional and Enterprise plans.

You can manage external partners similarly to internal team members. To learn more, see Managing a Partner Workspace.

Manage Guests

You can manage Guests in your team dashboard. To remove guests, select the remove guest icon next to the user. To upgrade a Guest user to a Developer, select Convert. When a Guest becomes a Developer, they get access to all team workspaces and can collaborate with other team members.

If you're on an Enterprise team, only Team Admins can assign a Guest user the Developer role.

Your team must have available seats or Auto-Flex enabled to change a user's role from the Guest role to the Developer role.

To review the workspaces and collections a Guest has access to, open your team dashboard. Locate the Guest user and select View resources. You can select the workspace name or collection name to open it in a new tab, or select the user's name to go to their Postman profile.

To learn more about sharing collections with guest users, see Share collections with guest users in your organization.

For information on how to remove a guest user from a team or collection, see Change guest user access to collections.

Manage groups

Groups are available on Postman Enterprise plans.

You can assign roles and provide access to team resources at scale with Postman groups. To learn how to create and manage groups, see Organize users into Postman groups.

Remove team members

If you're on a Postman Enterprise plan, you can set up and use SCIM to automate de-provisioning through your identity provider (IdP).

To remove a member from your team, go to your team dashboard. Select the delete icon next to the team member's name. Then to confirm, select Remove Member. When you remove a team member, you will still retain access to any data they have shared with the team.

Reassign personal workspaces to another team member to ensure the team continues to have access to any unshared work done by the user being removed. You must reassign their personal workspaces if one of the following is true:

• They're from an Enterprise team.
• They're from a Free, Basic, or Professional team, and they have an account.

An account isn't associated with a team, and only the user can access it. To access an account, see Switch between teams.

When you remove a team member, their personal workspaces and the data within them move to an account if the following is true: they're from a Free, Basic, or Professional team and they don't have an account.

For help in removing team members and transferring data based on your team's configuration, contact Postman support.

Note that when you remove a member from your team, this doesn't automatically reduce the number of paid seats for your team unless the member was added by Auto-Flex during the current Auto-Flex cycle. If you want to reduce the number of paid seats on your team, a member of your team with the Billing role can edit your plan.

Change team size

You can change your team's size to accommodate more collaborators at any time in your billing cycle. To do so, you need to have the Billing role or request help from a team member with the Billing role.

To change your team's size, you have two different options:

• Change the number of paid seats - Change your team's number of paid seats in the billing dashboard.
• Turn on Auto-Flex - Enable Auto-Flex to let your team invite more users without having to pay in advance for more seats.

For more information, see Team and plan changes.