Set up a Partner Workspace

From May 2025, you can begin creating team-to-team Partner Workspaces, which ensures easier and more secure collaboration between you and your partners. Your partners can use domain capture and SSO to authenticate to your Partner Workspaces and you can track your partnerships in a new team setting called Partnerships. That means no switching between teams and more control over partnerships. If you have older Partner Workspaces, they’ll continue to work as-is. However, you can migrate your older workspaces to take advantage of the new capabilities.

Learn how to create, configure, and invite collaborators to your Partner Workspace. Start by using a template or by moving your collections to a Partner Workspace. Explore the roles that enable you to invite third parties to your organization.

Create a Partner Workspace

  1. Click Workspaces from the header, then click Create Workspace.

    Create new workspace
  2. You can use workspace templates to help you set up a new workspace. Select a Partner Collaboration template to populate the workspace with helpful information and sample collections, or select Blank workspace to create an empty workspace. Then click Next.

    Create new Partner Workspace with a template
  3. Select a name for your workspace.

  4. Select Partner as your workspace type.

  5. If you’re not an admin, add a note for the workspace creation approval.

  6. Click Create.

    Create Partner Workspace

Anyone with permissions to create workspaces can request to create a Partner Workspace, but it must be approved by a Partner Manager. If no Partner Manager role is assigned, the Team Admin is auto-assigned the Partner Manager role when they create their first Partner Workspace.

On Professional plans, anyone can create a Partner Workspace and the Partner Manager role isn’t available.

If you’re not a Super Admin or Partner Manager, you must submit your request for approval. You can also add an optional note to your request. The workspace type will be set to internal until your request is approved. Postman will notify you when a Partner Manager reviews your request and approves or denies it.

To convert an existing workspace to a Partner Workspace, do the following:

  1. Open the workspace. In the Overview tab, click Settings.
  2. Under Workspace types, select Partner.
  3. Click Save Changes.

Anyone with permissions to change workspace visibility can request to convert a workspace into a Partner Workspace, but it must be approved by a Partner Manager. If you’re not a Super Admin or Partner Manager, Postman will mention this, and you can add an optional note to your request. Postman will notify you when a Partner Manager reviews your request and approves or denies it.

When a workspace is converted to a Partner Workspace, Postman sends in-app and email notifications to all workspace members.

Configure a Partner Workspace

Before sharing a Partner Workspace with external collaborators, you can set your partnership up for success by moving or forking relevant elements into it.

You can also use workspace templates to help set up a new Partner Workspace. For more information, see Apply a template to a workspace.

Move elements to a Partner Workspace

You must be a Super Admin, Workspace Admin, or Partner Manager to move an API, collection, environment, mock server, or flow to a Partner Workspace.

To move an element to a Partner Workspace, do the following:

  1. Click Options icon View more actions next to the element you want to move, then select Move.

  2. Use the search bar to find the workspace you’d like to move the element to, or use Filter icon Filter by visibility.

    You can move elements to Partner Workspaces that you have access to.

  3. Select the workspace, then select Move (Collection, API, Flow, Environment, or Mock Server).

    Move element Partner Workspace

Items related to what you’re moving, such as monitors and mock servers, won’t move with the element automatically. For more information, see Move elements to workspaces.

If you’d like to keep certain elements in other workspaces, you can fork them into Partner Workspaces to help keep them up to date with any changes to the parent element.

Invite collaborators to a Partner Workspace

Workspace Admins, Partner Managers, and Partner Leads can invite Partners to Partner Workspaces. Partners must be external, third parties to your organization. When you assign a Partner the Workspace Editor role, they can edit all workspace resources in the Partner Workspace, including collections. A paid seat is consumed when you assign partners the Workspace Editor or Collection Editor roles. Learn about adding paid seats.

The Partner Editor role is available with Postman Professional and Enterprise plans with the Partner Editor add-on.

Workspace Admins and Partner Managers can invite team members to Partner Workspaces.

Learn more about team and Partner Workspace roles.

Invite Partners to a Partner Workspace

To invite Partners to a Partner Workspace, do the following:

  1. Open the workspace, click Settings in the workspace’s Overview tab, and then click Invite. You can also click Invite in the Postman header.

    Alternatively, you can copy and share the link to the Partner Workspace by clicking Link icon Copy partner link. Invite links give Partners the Viewer role. Once the Partner accesses the workspace, you can change the role.

    Invite partners via link
  2. (Workspace Admins and Partner Managers only) Select Partners, then click Continue.

  3. Enter the name, email, or group name of the Partners. You can also import users using the Add from file option.

  4. Set the workspace role.

    Your team must have available seats or Auto-Flex enabled to invite a Partner as a Workspace Editor. Otherwise, the Partner will be assigned the Workspace Viewer role, giving the Partner permission to view all workspace resources. Assigning a Partner the Workspace Viewer role doesn’t consume paid seats.

  5. (Workspace Admins and Partner Managers only) Select Make them Partner Lead if you’d like them to also be able to manage and invite Partners within the workspace.

  6. Click Invite Partners or copy the link to share.

    Invite partners

Partner invites must be accepted through the Postman account associated with the invited email address. If a Partner wants to use a different email address, or if an invite was sent to the wrong email, you can revoke the invite and send a new one. An invite can’t be forwarded to someone else.

The partner invite link will work for both single and multi-partner workspaces.

Pro-tip: If you have a partner developer portal and want your Partners to test their APIs easily using Postman collections, create a multi-partner workspace, add the collections and environments, then add the Partner invite link to the portal. This will help any Partner who onboards to the developer portal to switch to Postman to try out the APIs fast.

Invite team members to a Partner Workspace

To invite team members to a Partner Workspace, do the following:

  1. Open the workspace, click Settings in the workspace’s Overview tab, and then click Invite. You can also click Invite in the Postman header.

    Alternatively, you can copy and share the link to the Partner Workspace by clicking Link icon Copy team link. Invite links give team members the Viewer role. Once the team member accesses the workspace, you can change the role.

    Invite team members to a Partner Workspace via link
  2. Select Team members, then click Continue.

  3. Enter the name, email, or group name of the team members. You can also import users using the Add from file option.

  4. Set the workspace role.

  5. Click Send Invite or copy the link to share.

    Invite team members to a Partner Workspace

Accept a Partner invite

When a Partner selects Accept Invite from their email, they can select a team they’re part of:

  • If they’re part of paid Postman teams, they can choose one of those teams.
  • If they’re only part of free Postman teams, then they need to choose one of those teams.
  • If they’re an individual user, they can join as an individual Partner.
  • If they don’t have a Postman account, invited Partners are prompted to create one and sign up as a Partner.

If the users don’t see any teams in the list, or if some teams are inaccessible, the admins of those teams have blocked the members of those teams from accepting Partner invites.

Last modified: 2025/05/20