Create an Organization in Postman

Postman Organizations is available with Postman Enterprise plans.

Postman Organizations streamline API collaboration, reduce clutter in teams, maintain tighter access controls, and prevent the unwanted exposure of work and secrets. Organizations enable you to replicate your internal structure by creating independent teams, each with its own set of managers and members. This setup prevents sharing sensitive information and gives each team better control over its membership.

Learn how to plan and set up your organization teams and workspaces. To manage your publisher profile, discoverability, custom domains, authentication, and active invite links, see Configure team settings.

Plan your organization setup

Before you set up your organization teams, consider the following:

• How many teams do you need and for which specific step in your API lifecycle?
• How will you name your teams and workspaces?
• Who will be on each team, and who will manage it?
• How many workspaces will each team need to begin collaborating?
• If you have Slack or Teams workspaces, which channels do you need to connect each workspace to post workspace updates?

Create organization teams

To create an organization team, do the following:

1. From the Home page, click Teams.

2. Click Create Team.

   

3. Name your team. The team will be taggable in the mentions using @, for example, “@api-developers”.

   

4. Select Add Members. To be added, members need to be part of the organization.

   Notes:

   • If no Team Manager is assigned, the Organization Manager can continue to manage the Team membership.
   • You can use Groups to assign Team membership, enabling control through an Identity Provider (IdP) and SCIM.

   

Create organization workspaces

To create workspaces for an organization team, do the following:

1. If you’re not continuing from the previous step, from the Home page, click Workspaces.

2. Click Create Workspace.

   

3. Select a blank workspace or a workspace template. Click Next.

4. Name the workspace.

   

5. Select the team for which to create a workspace. Otherwise, your team will be prepopulated.

6. Select Internal for workspace type. You can update the workspace visibility at any time. As a best practice, workspaces need to remain internal until all the work has been completed and approved.

7. Select Everyone in [TeamName] to allow all Team Members with access to the workspace, whether invited or shared, to edit the workspace elements. Collaborators will still have to be added to the workspace roles to enable their access. For stricter access, select Only you and invited people. If there’s a specific need to open the workspaces to all people in the Organization, select Everyone in [OrgName].

8. Click Create.

After you create one or more workspaces, you can add workspace details, connect the workspace to a Slack or Teams channel, and post a workspace update announcing the workspace is ready for collaboration.

Edit workspace details

Postman recommends adding a useful workspace description and other details to help organization teams start collaborating.

To identify workspaces further, do the following:

1. Under Workspace description, add a description.
2. Under About, add a summary.
3. Under Tags, add tags.

Your teams can continue to edit workspace details as their workspaces, collections, and APIs evolve.

To learn more, see Edit workspace details.

Announce your team and workspace setup

To post a workspace update, do the following:

1. From the workspace, select Updates.

2. Select Post an Update.

3. Enter a title and a description of your update.

4. Select Announcement from the dropdown list.

5. (Optional) Add a summary describing the change.

6. If you’ve integrated Postman with Slack or Teams, you can post a team workspace update to a channel on one or both of those apps. Click Post Update.

   If a social channel is already subscribed to workspace updates the checkbox next to Share on Slack (or Teams) on the bottom right of the post is checked. If not, click Connect in the workspace overview to subscribe to a channel. Ensure the box is checked to send notifications when someone posts a workspace update. To learn more, visit the Slack and Teams integrations pages, respectively.