Collaborate with your team in Postman

Collaborate with others in Postman using team workspaces. You can find a team within your organization or join by other means enabled by your organization. If you sign up for a Postman free plan as an individual user, you can create a team where to up three users can work together at no cost.

For more information about creating teams, see Create a team in Postman.

When you join a team in Postman, you can either move your workspaces and transfer ownership to the team or keep your workspaces separate and maintain ownership in your account.

The decision to join a team affects your account in the following ways:

• When you move your workspaces to a team, your account will no longer exist. You'll have the option to switch between teams, rather than work in an account.
• When you keep your workspaces, you'll retain your account. You can switch between the team and your account at any time.

In certain cases, your personal workspaces and the data within them automatically transfer when you join a team. For more information, see Join a team.

When you leave a team, a Postman account is created for you, if you don't already have one. If you're deactivated through SCIM but are a member of other teams, you'll keep access to your account and other teams to which you belong. If you aren't a member of any other team and don't have an account, you won't be able to authenticate and will need to contact support.

Find teams within your organization

When you first join Postman using an email address with your company's domain, Postman provides you with a list of available teams you can join within your organization. Select Show More to see the full list of teams.

Select Join next to a team. If a Team Admin has set a mandatory question, answer the question and select Submit.

Once you've verified your account, the Team Admins will receive a notification of your request. When they approve it, you'll be able to access the team and collaborate on API projects within it.

Join a team

There are several ways you can join a Postman team:

• Email invite - Select Join Team in the email invite. Create a new Postman account or sign in to an existing one. After signing in, you'll be redirected to your new team.
• Invite link - Open the link and select Accept Invite. Create a new Postman account or sign in to an existing one. After signing in, you'll be redirected to your new team.
• Team discovery - When first joining Postman, you can find teams to join within your organization.
• Team Request for Access (RFA) - If you access a link to a resource (for example, a collection or request) from a team you are not a member of, you can select to request access to that team. An admin will need to approve your request.
• SSO automatic provisioning - If a team in your organization has automatic provisioning enabled in their SSO configuration, you can join the team by signing in to Postman with SSO.
• SCIM provisioning - If your organization has enabled SCIM provisioning, you may be added to your organization's Postman team and receive an email invite. Select Join Team in the email and sign in to Postman with SSO.
• Domain capture - If your organization has configured domain capture and you use or create an account associated with a verified domain, Postman will notify you when you next sign in that your account is managed by your organization.

You can be a member of up to ten Postman teams, regardless of if they're on the free, Basic, Professional, or Enterprise plan. However, if an Enterprise team within your organization implements domain capture, you won't be able to remain on or join extra Postman teams with your captured accounts.

If you have an account and join a team, you can choose to transfer your personal workspaces and the data within them to the team or keep them separate. In the following cases, your personal workspaces and the data within them automatically transfer when you join a team:

• If you request to join a team and are approved by a Team Admin.
• If the team has SCIM provisioning enabled.
• If the team has domain capture enabled.

When you join an Enterprise team, Super Admins have access to all personal workspaces you transfer over and any you create within the team moving forward.

When you leave a team, your personal workspaces within the team and their data will remain with the team and no longer be accessible to you in some situations. See Leave a team for details. Personal workspaces in a team refers to workspace visibility and not data ownership.

Switch between teams

If you belong to multiple teams, you can sign in to them at the same time with your Postman account. To switch between teams, select your avatar in the top right. Select a team to open.

If you're a member of two or more teams, you can also select Create Team to create a new team.

If you have an account, switch to it by selecting your avatar in the top right. Then select your avatar and username labeled Individual.

Leave a team

You can leave a Postman team by selecting your avatar in the top right, then Settings. Select Teams on the left.

Select Leave Team to the right of a team to leave it. If you're a member of an Enterprise team that has SCIM configured, you must contact a Team Admin to remove you from the team.

When you leave a team, you no longer have access to the team's workspaces, including personal workspaces, or any of the elements in them. You must reassign your personal workspaces to a remaining team member before leaving if one of the following is true:

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

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

If you were on a Free, Basic, or Professional team and you don't have an account, when you leave a team, you can choose to move your personal workspaces and the associated data to a new account.

If you're the last member to leave a team, the team will be deleted. You will no longer have access to the team's workspaces, including personal workspaces, or any elements in them. Export your Postman data prior to leaving the team to ensure it stays with you.