Set up and manage a Postman Sandbox

Learn how to set up and manage a Postman Sandbox for an Enterprise organization. A sandbox is an isolated environment that includes standard Postman features so that they can be used for testing. It appears as a distinct team in the account switcher (labeled SANDBOX) and has its own members and resources. Use the sandbox to test and evaluate features before rolling them out to your full team.

Here are the key characteristics of the Postman Sandbox:

• The sandbox environment is fully isolated. Workspaces, collections, and API definitions that users create don’t appear in the parent organization and vice versa.
• The SANDBOX badge in the top-right corner is a persistent visual indicator that you are operating inside the sandbox context, not your main organization.
• You can manage sandbox team members from the parent organization’s Organization resources settings only. The sandbox’s own invite flow doesn’t support generating invite links.
• Many Admin settings, including authentication and custom domains, aren’t available in the sandbox. Other features may only be available at lower usage rates than your production Postman instance. For more information, see Limitations.

Prerequisites

To set up and manage a Postman Sandbox, you need the following:

• Have Admin access to the parent Enterprise organization.
• Enable the sandbox feature for your organization under Organization resources.
• Accept the sandbox terms of use and understand that the sandbox is intended for testing and evaluation purposes, not for production use.

Manage sandbox team members

Invite generation isn’t allowed for sandbox teams. Attempting to use the Copy Invite Link option in the invite dialog produces an error. Users can only join the sandbox through team assignment or a separate SSO authentication flow.

To add members to the sandbox, do the following:

1. In the upper right, go to Settings > Organization settings > Organization resources. Then, expand Manage sandbox team to reveal the Sandbox team members panel.

   

2. Click the search field and select a member from the dropdown list.

3. Click Add.

4. Read the terms and click Accept & activate.

To remove members from the sandbox, go to the sandbox’s membership page ( Settings > Organization settings > Members) and click next to a member’s name. Removing a member from the sandbox doesn’t remove them from the parent organization.

Switch to the sandbox team

Once configured, users can access the sandbox by switching teams:

1. Click your avatar or team name in the top-right corner to open the account menu.
2. Click Switch to and select the sandbox team in the list of all teams and organizations associated with your account.

The home page updates to reflect the sandbox status with the SANDBOX badge in the top-right corner. The Pick up where you left off section shows No recent items, since the sandbox starts empty.

Limitations

Certain limitations and restrictions apply to Postman Sandboxes, including access and control limitations and permitted use limitations.

Access and control

• Postman may delete sandbox data at any time, with or without notice.
• At its discretion, Postman may restrict the number of users, limit the duration of access, or restrict usage.
• Auto-Flex isn’t available.
• Content can’t be transferred from the sandbox to your production environment.

Permitted use

• Strictly for use with test data.
• Strictly for evaluation, testing, development, demonstration, or other non-commercial internal use.
• Provided “as-is”, with no service level commitments, indemnities, or warranties.
• May not include all features or functionality available in production.