Configuring team settings

Your Team Settings allow you to manage items such as your team's profile, discoverability, custom domains, billing details, authentication, and active invite links.


Accessing team settings

You can access team settings by navigating to the Team dropdown menu in the upper right corner and selecting Team Settings.

Team menu with Team Settings selected

Editing your team profile

When you select Team Settings, you will be automatically directed to Team Profile. Here, you can edit your team's logo, cover photo, domain, favicon, and profile visibility.

Edit team profile

Customize your team's look. Keep in mind the following when uploading a logo, cover photo, or favicon:

  • Logos and cover photos must be 500 KB or less in size and must be in .jpg, .jpeg, or .png format.
  • Logos must have a 1:1 aspect ratio (height:width), and cover photos must have a 1:7.5 aspect ratio. If your image has a different aspect ratio, Postman prompts you to select a portion of your image to display.
  • Favicons must be in .ico format, no larger than 32x32 pixels, and 500 KB or less in size. Your favicon is displayed on the browser tab of your team's published documentation site.

Make your team discoverable. If you enable your team's public profile, your team will be visible on Postman's API Network, along with any APIs, collections, and workspaces your team has published. You can also add an About your team section, a link to your website, and links to social media accounts to your team's public profile.

Making your team discoverable

You can select Team Discovery from the left-hand menu to view your options for making your team discoverable to other Postman users with email addresses from your team's domain.

See Team Discovery for more information on this feature and the admin and user experience it provides.

Edit team profile

Adding custom domains

Select Custom Domains from the left-hand menu to add, update, or remove custom domains for your API documentation.

Visit Using custom domains for information on adding, verifying, troubleshooting, and publishing to custom domains.

Custom domains dashboard

Updating billing details

Select Billing Details from the left-hand menu to add to or update your team's billing information including email, address, and VAT ID (if applicable).

View Adding custom information to invoices for information on modifying new and existing invoices.

Updating billing details

Editing authentication methods

SSO is available on Postman Professional and Enterprise plans.

Select Authentication from the left-hand menu to configure or reconfigure your team's authentication methods.

See Configuring SSO for a team for details on how to configure your team's custom SSO setup and manage user accounts.

Editing authentication methods

Understanding roles and permissions

Select Roles and Permissions from the left-hand menu to view a complete list of permissions for team members' roles at a team, collection, workspace, API, and mock server level.

View Defining roles for more information on roles you can assign to members of your team and Managing your team for an overview of managing roles and users within your Postman team.

Roles and permissions descriptions

Last modified: 2022/01/21