Set up a Partner Workspace

Partner Workspaces are available with Postman Professional and Enterprise plans.

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

Select Workspaces from the header, then select Create Workspace.
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 select Next.
Select a name for your workspace.
Select Partner as your workspace type.
If you're not an admin, add a note for the workspace creation approval.
Select Create.

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:

Open the workspace. In the Overview tab, select Settings.
Under Workspace types, select Partner.
Select 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:

Select View more actions next to the element you want to move, then select Move.
Use the search bar to find the workspace you'd like to move the element to, or use Filter by visibility.

You can move elements to Partner Workspaces that you have access to.
Select the workspace, then select Move (Collection, API, Flow, Environment, or Mock Server).

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. Your team can invite three partners assigned the Workspace Editor role at no extra cost. 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.

Learn more about team and Partner Workspace roles.

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

Open the workspace, select Settings in the workspace's Overview tab, and then select Invite.

You can also select Invite in the Postman header.
(Workspace Admins and Partner Managers only) Select Partners, then Continue.
Enter the name, email, or group name of the partners.
Set their 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.
(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.
Select 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.

Partners will sign in to your team with a Postman username and password, even if your team is restricted to signing in with SSO.

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

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

Open the workspace, select Settings in the workspace's Overview tab, and then select Invite.

You can also select Invite in the Postman header.
Select Team members, then Continue.
Enter the name, email, or group name of the team members.
Set their workspace role.
Select Send Invites.