Configure team settings

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

Access team settings

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

Manage your team profile

Your public team profile gives you a way to share important information about your team with other Postman users. The 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 team profile, customize your team's branding, and manage the public visibility of your team profile.

Your team profile includes:

• A short summary about your team and the work you do.
• A verified team badge that, if approved, shows your team is authentic.
• Social media links like your GitHub profile.
• A list containing links to your team members' profiles.
• A Team Description section.
• A Highlights section with pinned elements.
• A Related collections and flows from the community section with collections and flows using your team's APIs (suggested by Postman).
• Links to all your team's public collections, APIs, workspaces, and flows.

Edit your team profile

Select Team in the header, then select Team Settings. Select Edit Your Public Profile to edit your team's summary, description, social media links, and highlights.

• Team summary - Select Add Team Summary to add a brief summary about your team and the work you do. To edit your team summary, hover over the section and select Edit team summary.

• 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.

• Members - Hover over this section and select Manage to manage your team members.

• About your team - Select Add Team Description to include information about your team and organization. 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.

• Highlights - Highlighting elements enables you to show off your team's work to other Postman users. If you don't choose any elements to pin to this section, Postman displays the most popular elements that you've worked on. To update the highlighted elements, hover over the section and select Edit highlights. Add or remove the desired elements, then select Save.

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 team profile public

A public team 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 enable your team's public profile, your team will be 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 team profile public, do the following:

1. In Team Settings, select Team profile.
2. Select Make team 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 select 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.