Creating the Run in Postman button

The Run in Postman button is a way to share your Postman Collection and integrate your API documentation or developer portal directly with the Postman app. Keep in mind, Run in Postman works well with API description formats like Swagger and RAML too. Just convert your file to a collection by importing it into Postman.

The Run in Postman button imports and opens a collection of API endpoints directly in the user’s Postman app. You can embed the button in your API documentation or your GitHub’s README to help developers get up to speed on your API faster.

Creating the Run in Postman button

To create the Run in Postman button, start in the Postman app. Make sure you are signed in to your Postman account, and that you have a collection to share.

  1. Click on the ellipses (…) next to the collection you would like to embed and select “Share”. 

    share collection

  2. Under the Embed Button tab, click the Generate Code button to upload the collection to the Postman servers.

    generate code

  3. Pick whether you would like a Dynamic button or a Static button.

  • The Dynamic button uses HTML and CSS, and works well if you want to add the button to your own website and you have permissions to edit the source code of the site.
  • The Static button uses Markdown, and works well if you need to add the button to a markdown document, such as a README.md file in your Github or Bitbucket repository.

  run in postman button code

Here’s an example markdown snippet:

[![Run in Postman](https://run.pstmn.io/button.svg)](https://www.getpostman.com/run-collection/:collection_id)

Here’s an example HTML snippet:

<a href="https://www.getpostman.com/run-collection/:collection_id" target="_blank"><img src="https://run.pstmn.io/button.svg" alt="Run in Postman"></a>

The :collection_id is a placeholder here and will be auto-filled in the markdown snippet.

Embed this button on your documentation pages or your GitHub repo’s README for the API.