- Installation and updates
- Sending your first request
- Creating the first collection
- Navigating Postman
- Keyboard Shortcuts
- Postman account
- New button
- Troubleshooting In-app Issues
- Customizing Postman
- Find and Replace
- Troubleshooting API requests
- Debugging and logs
- Authorizing requests
- Capturing HTTP requests
- Generate code snippets
- Making SOAP requests
- Working with Tabs
- Using GraphQL
- Visualize API responses
- Intro to collections
- Creating collections
- Sharing collections
- Managing collections
- Requesting access
- Using Markdown for descriptions
- Data formats
- Working with OpenAPI
- Commenting on collections
- Version Control for Collections
- Intro to scripts
- Pre-request scripts
- Test scripts
- Test examples
- Branching and looping
- Postman Sandbox
- Postman Sandbox API reference
- Intro to collection runs
- Starting a collection run
- Using environments in collection runs
- Working with data files
- Running multiple iterations
- Building workflows
- Sharing a collection run
- Debugging a collection run
- Command line integration with Newman
- Integration with Jenkins
- Integration with Travis CI
- Newman with Docker
- Documenting your API
- Viewing documentation
- Authoring your documentation
- Publishing your docs
- Custom documentation domains
- Intro to Monitoring
- Setting up a monitor
- Viewing monitor results
- Monitoring APIs and websites
- Set up integrations to receive alerts
- Pricing for monitors
- Troubleshooting monitors
- FAQs for monitors
- Intro to mock servers
- Setting up a mock server
- Mocking with examples
- Mocking with the Postman API
- Matching algorithm
- Introduction to APIs
- Managing APIs
- Sharing APIs and managing roles
- The API Workflow
- Validating Elements Against Schema
- Versioning APIs
- Reporting FAQs
- Viewing and analyzing APIs
- Intro to Workspaces
- Creating Workspaces
- Managing Workspaces
- Using Workspaces
- Sharing collections in Workspaces for version 5
- Viewing changelogs and restoring collections
- What is Postman Pro
- Purchasing Postman Pro
- Upgrading to Postman Pro from a trial team
- Team Settings
- Changing your plan
- Managing your team
- Migrating to Postman v7
- Roles and permissions
- Intro to Enterprise
- Purchasing Postman Enterprise
- Running Postman monitors using static IPs
- Intro to SSO
- Configuring SSO for a team
- Logging in to an SSO team
- Configuring Microsoft AD FS with Postman SSO
- Setting a custom SAML in Azure AD
- Setting up custom SAML in Duo
- Setting up custom SAML in GSuite
- Setting up custom SAML in Okta
- Setting up custom SAML in Onelogin
- Setting up custom SAML in Ping Identity
- Audit logs
- Publishing API documentation
Adding to Postman templates
You can share your documentation for any collection you publish by adding it to the Postman Templates. Adding your templates makes them available to the Postman community through the app via New > Templates and on the web.
Your template listing provides access to the documentation for your API collection, and the Run in Postman button, which allows anyone to import the collection directly into the Postman app. Community members can browse and search for templates to learn, and automate tasks relevant to a wide variety of use cases. People can also access your Postman profile via your template listings.
By publishing your collection docs to the Postman templates, you're sharing both human-readable and executable data that helps people get started using APIs. Your docs can outline how to use a single endpoint as well as how to integrate with an API as a whole, helping community members learn API skills and discover available services.
If you're publishing documentation from a team API, you can add it to the API Network as part of your team listing.
When you add to the Postman templates, your listing will also be discoverable via your profile. You can set your profile up before or during publication, or Postman will generate a profile that you can optionally edit later.
To add to the shared Postman templates, you first need to document and publish a collection. You can share your collection to the Postman templates during the docs publishing process, or later. During publication, enable Collection discovery and select Add to Postman Templates.
If your collection documentation is already published, you can make it discoverable by editing the published docs.
You can access your published docs from the Postman app (select the collection and click View in web), or from the web dashboard (navigate to Workspace > Collections and click the published collection title).
Click Allow Collection Discovery to set up your docs for sharing.
Select Add to Postman Templates.
Enter display details for your template listing, including Template Name, Summary, and Description. Your description will be automatically pulled from any description you have added to your collection already, and should include the information potential users will need to know whether to try the template or not.
Select any relevant categories for your template—users will be able to browse using categories in both the Postman app and on the web.
You can choose to publish your templates under your personal Postman profile, or from a team profile.
Templates published from a team will also appear in the API Network listing Templates tab for the team.
To set up your profile, click Public Profile Settings or navigate to your settings in the web dashboard. Click Enable Public Profile to allow your templates to be published.
You can customize your profile URL and name, and add a description people will see alongside your templates. You can also set a profile photo from your account settings.
If you choose to disable your profile, you won't be able to publish any new templates, and any previously published will be unpublished.
When your publish settings are complete, click Publish Collection. You will see a confirmation of your template listing and public profile.
Your templates will be discoverable from inside the Postman app using New > Templates and on the web.
Your template listing will show the description and publisher details, plus links to the documentation and the Run in Postman button people can use to import the collection and try the requests in the Postman app.
Your profile listing will be available both in the Postman app, and on the web, listing all of your published templates.
Clicking the title of a template will open its listing in the web browser.
Check out some tips for making the most of your listing.