Edit

Share via


Export API definition to Postman for API testing, monitoring, and development

APPLIES TO: All API Management tiers

To enhance development of your APIs, you can export an API fronted in API Management to Postman. Export an API definition from API Management as a Postman collection so that you can use Postman's tools to design, document, test, monitor, and collaborate on APIs.

Note

Only the API definition can be exported directly from API Management to Postman. Other information such as policies or subscription keys isn't exported.

Prerequisites

  • Complete the following quickstart: Create an Azure API Management instance.

  • Make sure that your instance manages an API that you'd like to export to Postman.

    Note

    Currently, you can only export HTTP APIs from API Management directly to Postman.

  • A Postman account, which you can use to access Postman for Web.

Go to your API Management instance

  1. In the Azure portal, search for and select API Management services:

    Screenshot that shows API Management services in the search results.

  2. On the API Management services page, select your API Management instance:

    Screenshot that shows an API Management instance on the API Management services page.

Export an API to Postman

  1. In the portal, under APIs, select an API.

  2. In the context menu (...), select Export > Postman.

  3. In the Run in dialog, select the Postman location to export to. You can select the option for the desktop app if you've installed it locally.

  4. In Postman, select a Postman workspace to import the API to. The default is My Workspace.

  5. In Postman, select Generate collection from this API to automatically generate a collection from the API definition. If needed, configure advanced import options, or accept default values. Select Import.

    The collection and documentation are imported to Postman.

    Screenshot of collection imported to Postman.

API development with API Management and Postman

API developers can rapidly iterate on API changes by using Postman's API testing, monitoring, and development capabilities.

APIs developed in Postman can then be exported and imported back into API Management as API revisions. This enables you to develop APIs in Postman and then deploy them to API Management for runtime access and management. Learn more

Caution

Use care when passing API Management subscription keys or other sensitive data in Postman. Postman Vault is recommended to store sensitive data as vault secrets in your instance of Postman, so you can safely reuse secrets in your collections and requests.