Enable domain capture in Postman

Domain capture is available on Postman Enterprise plans with the Advanced Security Administration add-on.

As a Team Admin, you can enable domain capture after you've completed its prerequisites, including adding and verifying a domain. Domain capture will move all of the existing users who are associated with your verified domain or subdomain to your Enterprise team. Moving forward, any Postman users who sign up for a new account with the relevant domain will be automatically added to your team.

Your team must have only SAML-based SSO authentication methods enabled to turn on domain capture. Alternative authentication methods, such as Postman or Google sign in, must be turned off.

To enable domain capture, navigate to the domain dashboard and create a request to claim accounts associated with the verified domain. When the request is approved, Team Admins can work with Postman support to manage accounts associated with the verified domain.

View unclaimed accounts

Team Admins can view unclaimed accounts in the domain dashboard. Unclaimed accounts are accounts associated with a verified domain and aren't yet part of your team. You can view unclaimed accounts before enabling domain capture. When you're ready to enable domain capture, create a request to claim verified accounts.

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 with the VERIFIED status you want to view unclaimed accounts for, and then select View Accounts.

   Optionally, you can select the number of unclaimed accounts next to the domain in the domain dashboard.

3. View the list of accounts not part of your team.

   

4. Optionally, you can select Export CSV to export the list as a CSV file. You will receive an email containing the download link.

Claim verified accounts

Team Admins can create a request with Postman support to claim verified accounts associated with a verified domain. Domain capture is enabled once the request is approved. Then you can work with Postman support to manage unclaimed accounts. Before you enable domain capture, you can view unclaimed accounts.

Learn more about the user experience after domain capture is enabled for your team.

To enable domain capture, do the following:

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 with the VERIFIED status you want to enable domain capture for.

3. Select Request To Claim. Postman support will then contact Team Admins to explain the effects of enabling domain capture.

4. Once the request is approved, a notification will display towards the top of the screen explaining that Account Capture has been enabled. You can contact Postman support to manage unclaimed accounts.

   

To view the status of your request to enable domain capture, select Manage next to the domain. After you select Request To Claim, the request status is changed to REQUEST SENT.

To turn off domain capture, you must contact Postman support.

Contact support to manage accounts

Once the request is approved to claim verified accounts, Team Admins can contact Postman support to claim accounts not part of your team, merge teams into your team, and restrict users to only work in your team.

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 with the VERIFIED status you want to contact support about.

   Domain capture must be enabled for the domain you want to contact support about. Learn more about enabling domain capture.

3. Select Contact Support.

   

User experience

When domain capture is enabled, new Postman users who sign up for Postman with email addresses associated with your domain or subdomain are automatically added to your team.

Existing Postman users with email addresses associated with the domain or subdomain will only be able to access Postman after joining your team. This applies to existing users who are part of other teams and existing individual users. The next time existing users sign in to Postman, they will get a notification that your team manages their account. Existing users can join the team using this notification.

You won't be able to selectively pick users you'd like to add to your team. Once enabled, the number of unclaimed accounts will reduce as these users sign in and join your team.

Existing users who were on other Postman teams 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. Users won't be able to remain on or join extra Postman teams with their captured accounts.

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

For more details on the effects of enabling domain capture, see Domain capture FAQs.

If users experience any issues when moving to your Postman team, reach out to Postman support.

Domain capture support and FAQs

For more information on the effects of enabling domain capture, see Domain capture FAQs.