Your Team Settings enable you to manage items such as your team's profile, discoverability, custom domains, authentication, and active invite links.
To access team settings, select Team in the header and then select Team Settings.
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:
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 the edit icon .
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 the edit icon .
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 the edit icon .
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 the edit icon . Add or remove the desired elements, then select Save.
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 team logo and cover photo, hover over the section and select the edit icon , then upload the image you want to use. To add a favicon, select Upload under the Favicon section.
Keep the following in mind when you upload a logo, cover photo, or favicon:
A public team profile encourages other users to collaborate with you in a public workspace, enabling you to 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:
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 Enable team discovery. Anyone from your domain can find and request to join your team.
To learn more about joining a team through shared links, see Manage team access through shared resources.
Team Admins will receive an email notification when team discovery is enabled 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 Update 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, including their answer to any question you set, or an optional note.
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.
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.
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.
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.
Last modified: 2023/06/21