Configure team settings

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

Access team settings

To access team settings, click Team in the header and then click Team Settings.

Manage your publisher profile

Your publisher profile gives you a way to publicly share important information about your team with other Postman users. The publisher profile brings together all your team's public resources in one place, and can serve as a developer portal for your API's consumers.

Super Admins, Admins, and Community Managers can edit your publisher profile, customize your team's branding, and manage the public visibility of your publisher profile.

Your publisher profile includes:

• A banner with your logo and a sentence describing the work you do.
• A verified team badge that, if approved, shows your team is authentic.
• An About us section that contains a brief summary about your team and the work you do.
• A Get to know us panel with links to your team members' profiles.
• A Social link panel with links to your social media like your GitHub profile.
• An Our content section with your featured public workspaces.
• A View Contents link in each featured public workspace to your team's public collections, APIs, and flows.

Edit your publisher team

Click Team in the header, then click Team Settings. Click Edit Your Public Profile to edit your team's summary, description, social media links, and featured public workspaces.

• About your team - Click Get started to add a brief summary about your organization and the work you do. The editor supports Markdown, or you can use the built-in text formatting tools. To update your team description, hover over the section and select Edit team description.

• Social links - Select Add Social Links to link to your website and social media accounts. To edit these links, hover over the section and select Edit social links.

• Get to know us - Hover over this section and select Manage team to manage your team members.

• Edit featured content - Manage your public Workspaces that appear as featured content. You can select up to three workspaces to display as featured content. The default is the top two workspaces by number of forks. If you have more public workspaces to add, they're available when a user clicks View all. The View content link under each public workspace displays the Collections, APIs, and Flows in that workspace.

Customize your team's branding

You can add a logo, cover photo, and favicon to your team profile. These assets help you establish your team identity and ensure consistent branding.

To add these assets, select Team in the header and then select Team Settings.

• To add a cover photo, hover over the section and select Upload cover photo, then upload the image you want to use. To remove it, select Delete cover photo.
• To add a team logo, hover over the section and select Upload profile photo, then upload the image you want to use. To remove it, select Delete profile photo.
• To add a favicon, select Upload under the Favicon section.

Keep the following in mind when you upload 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 part 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 appears on the browser tab of your team's published documentation site.

Make your publisher profile public

A public publisher profile encourages other users to collaborate with you in a public workspace. You can ask for contributions, gather feedback, and increase your API's discovery in search results.

If you make your publisher profile public, your team is visible on the Postman API Network, along with your public workspaces, collections, APIs, and flows. Learn more about the Postman API Network and best practices for sharing elements.

To make your publisher profile public, do the following:

1. In Team Settings, select Team profile.
2. Select Make publisher profile public to set the profile to public.

Enable joining through links

Users can share collections and other elements with their team and users who aren't part of their team. As an Admin, you can choose to automatically approve each request to join a team through a shared resource.

In Team Settings, select Team access on the left, then turn on Allow people to automatically join from resource links.

Upon approval, the new team member is assigned the Developer role.

Your team must have available seats or Auto-Flex enabled to invite more team members. If your team has SSO enabled, users who aren't part of your team will be required to sign in using your team's SSO.

Enable team discovery

Team discovery encourages collaboration by easing the onboarding process for new team members. When team discovery is enabled, users who have a verified email address with your company's domain can request to join your Postman team.

In Team Settings, select Team access on the left, then turn on Make this team discoverable. Anyone from your domain can find and request to join your team.

Team Admins receive an email notification when team discovery is active, and only if the user has verified their email address.

You can optionally add a question for pending team members to answer when they request to join your team. Enter your question and select Save Question. Anyone who requests to join the team will be prompted with the question. If you don't specify a question, team members can still add a note when they request to join the team.

All Team Admins will receive a notification when someone requests to join your team after verifying their email address. This includes their answer to any question you set, or an optional note.

Enable automatic joining for team discovery

You can allow users with verified emails to automatically join your organization's team without requiring admin approval. Automatic joining reduces friction in collaboration and accelerates the time it takes for new members to begin working within teams.

Team Admins receive an email notification when users automatically join and can manage memberships by removing users if necessary.

In Team Settings, select Team access on the left, then turn on Allow people to automatically join this team. Anyone from your domain can find and join your team.

As a result of this action, the Make this team discoverable setting will also be turned on.

Review Secret Scanner patterns

Custom patterns are available with Postman Enterprise plans.

Select Secret Scanner to review default patterns for tokens issued by common service providers that the Postman Secret Scanner scans for. You can also add and review custom patterns that scan for your team's proprietary tokens and third-party app tokens.

See Secret Scanner to learn more about scanning public workspaces to detect exposed secrets.

Add custom domains

Select Custom Domains to add, update, or remove custom domains for your API documentation.

See Use custom domains for information about adding, verifying, troubleshooting, and publishing to custom domains.

Use installed apps

Select Installed apps to enable all members of a team to use the same stored authorization details when adding integrations.

See Add new integrations using installed apps in Postman for more information about adding and using installed apps in integrations.

Edit authentication methods

SSO is available with Postman Enterprise plans.

Select Authentication to configure or reconfigure your team's authentication methods.

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