Domain capture FAQs

Domain verification is available on Postman Enterprise plans. Domain capture is available on Postman Enterprise Ultimate plans.

General questions

What happens to captured users and their data (collections, environments) when domain capture is enabled?

The experience for captured users depends on their prior team status:

  • If a captured user is already on your organization's team and is not a member of any other teams, nothing changes for them.
  • If a captured user is a member of multiple teams, including your organization's team, they will no longer be able to authenticate into any other teams they are a member of.
  • If a captured user isn't part of any team:
    • All existing user sessions are revoked.
    • The next time the user logs in, they will be prompted to join your organization's team using SSO.
    • When the user authenticates into your organization's team using SSO, their existing data will be transferred to the team.
  • If a captured user is part of an existing free or paid team:
    • They're removed from their existing team.
    • All existing user sessions are revoked.
    • The next time the user logs in, they will be prompted to join your organization's team using SSO.
    • Users can authenticate into your organization's team using SSO.
    • They will lose access to all data from their earlier teams, including personal workspaces. No data will be transferred from their earlier teams to their new team.

      To transfer an existing user's collections and environments from their earlier teams to their new team, contact Postman support.

  • If a captured user is the last Admin of an existing free team:
    • They're removed from the team and the remaining users are assigned the Admin role.
    • All existing user sessions are revoked.
    • The next time the user logs in, they will be prompted to join your organization's team using SSO.
    • Users can authenticate into your organization's team using SSO.
    • They will lose access to all data from their earlier teams, including personal workspaces. No data will be transferred from their earlier teams to their new team.

      To transfer an existing user's collections and environments from their earlier teams to their new team, contact Postman support.

  • If a captured user is the last Admin of an existing paid team:
    • Postman support will contact your Team Admins to discuss how to approach this prior to enabling domain capture for a verified domain in your team.
    • All existing user sessions are revoked.
    • The next time the user logs in, they will be prompted to leave their existing team.
    • They will need to contact Postman support to assign the Admin role to another team member and remove them from the team.
    • Users can authenticate into your organization's team using SSO.
    • They will lose access to all data from their earlier teams, including personal workspaces. No data will be transferred from their earlier teams to their new team.

      To transfer an existing user's collections and environments from their earlier teams to their new team, contact Postman support.

Can a Team Admin view the list of user accounts that will be captured before enabling domain capture?

Yes, a Team Admin on an Enterprise Ultimate plan can view the list of the unclaimed Postman accounts that will be captured prior to confirming they'd like to enable domain capture. To learn more, see View unclaimed accounts.

Does adding a domain automatically add all the team members with the organization’s domain to the organization’s team?

No, after a Team Admin adds and verifies a domain and completes the prerequisites for enabling domain capture, they can create a request to enable domain capture. Postman support will then contact Team Admins to explain the effects of enabling domain capture. To learn more, see Enable domain capture in Postman.

How do I delete a domain?

Team Admins can delete domains and subdomains from your team by navigating to the domain dashboard.

  1. Open Postman and select Team > Team Settings in the Postman header. Select Authentication in the left sidebar, then select the Domains tab.
  2. Select Manage next to the domain you want to delete.
  3. Select Delete Domain.

Who can I contact for help?

If you have additional questions or are unable to verify your domain or enable domain capture, please contact your Customer Success Manager or Postman support for assistance.

Last modified: 2023/10/03