Create a Run in Postman button for your API consumers

Create a Run in Postman button to enable users to instantly fork your Postman collections into their workspaces. You can embed the button in your website or a README to enable developers to interact with your API.

Active Run in Postman buttons are automatically updated with any changes in the original collection. This provides your consumers with the most recent version of your collection, without publishers having to manually update the collection’s link. For example, you can click the following Run in Postman button to fork the most recent version of the Postman API collection:

To create a Run in Postman button, your collection must be in a public workspace. If it isn’t, you’ll need to change the workspace visibility to public or move the collection to a public workspace.

Create a Run in Postman button

To create a Run in Postman button, do the following:

1. Access the Postman API Network. If you’re on a paid plan, you can click API Network in the Postman header, then select Postman API Network.

2. Click Create New in the left menu, then select Run in Postman button.

3. Search for and select a public collection you want to share. To replace the collection, click Choose a different collection.

4. (Optional) Select an environment.

5. Click Next.

6. Choose an embed code format that’s HTML or Markdown friendly:

   • HTML friendly — This embed code uses JavaScript, HTML, and CSS, so you can customize the button for a website. You can customize the embed code to dynamically create and update environments and add environment variables to a user’s workspace.

   • Markdown friendly — This embed code uses Markdown, so you can display it in a README, blog, or other Markdown document.

7. Click Copy Code.

8. Embed the code where you’d like to display the button, such as your organization’s public API documentation.

Use a Run in Postman button

Click the Run in Postman button to open the page where you can fork the collection to your workspace. Forking the collection into your workspace lets you contribute to the source collection using pull requests.

You can also view the collection in a public workspace and import a copy of the collection using the provided links. All collections shared with Run in Postman buttons come with fork counts that help you and your consumers understand how developers use the API.

Published Run in Postman buttons are automatically updated with changes in the original collection. This enables your consumers to always get the most recent version of your collection, without publishers having to manually update the collection’s link.