***

title: Deploy to Azure API Management from the Postman API Builder
updated: 2025-10-10T00:00:00.000Z
slug: >-
docs/integrations/available-integrations/azure-api-management/deploying-an-api-azure
max-toc-depth: 2
----------------

[Azure API Management](https://azure.microsoft.com/en-us/services/api-management/) enables developers to deploy API gateways for APIs hosted in Microsoft Azure, other cloud platforms, or on-premises. Once connected to Azure API Management, you can view your API deployment status and history from within Postman. You can also export your OpenAPI definition from Postman to Azure API Management, or import a definition from Azure to use it in Postman.

## Connect to Azure API Management

To connect Azure API Management, do the following:

1. Click **APIs** in the sidebar and select an API.

2. Click **Deployments**, and then select **Microsoft Azure**.

3. You'll be prompted to authorize Postman to access your Microsoft Azure account. After you grant access, you can close the browser tab and return to Postman.

4. Enter information about the Azure API Management service you want to connect to your API:

   * **Subscription** - The [subscription](https://learn.microsoft.com/en-us/microsoft-365/enterprise/subscriptions-licenses-accounts-and-tenants-for-microsoft-cloud-offerings?view=o365-worldwide#subscriptions) where the service was created.
   * **Resource Group** - The [resource group](https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/manage-resource-groups-portal) that contains the service.
   * **Service** - The Azure API Management [service instance](https://docs.microsoft.com/en-us/azure/api-management/api-management-key-concepts) used for deploying your API.
   * **API Version** - The Azure API [version](https://docs.microsoft.com/en-us/azure/api-management/api-management-versions) that corresponds to your API in Postman.

5. To connect more Azure API Management services, click <img alt="Add icon" src="https://assets.postman.com/postman-docs/aether-icons/action-add-stroke.svg#icon" width="16px" /> **Add Service**. To remove a service, click **Remove**.

6. When you're finished adding services, click **Connect**.

   <img alt="Azure API Management setup" src="https://assets.postman.com/postman-docs/v10/azure-apim-setup-v10-0-25.jpg" />

After setting up the connection, you can choose to [import a definition from Azure API Management](#import-a-definition-from-azure). If you don't want to import a definition, click **Maybe later**. You can import a definition at any time after connecting to Azure API Management.

<img alt="Azure API Management import definition during setup" src="https://assets.postman.com/postman-docs/v10/azure-apim-setup-import-v10-0-25.jpg" />

## View Azure API deployments

After connecting to Azure API Management, you can view the deployment status and history for your API definition in Postman. Click **APIs** in the sidebar and select an API, then click **Deployments**.

For each connected API Management service instance, you can view the resource group, location, subscription, and virtual IP address (VIP).

<img alt="Viewing Azure API Management services" src="https://assets.postman.com/postman-docs/v11/azure-apim-deployments-v11.jpg" />

Select a service to view more details about the connected Azure API version.

* **Revisions** - [Revisions](https://docs.microsoft.com/en-us/azure/api-management/api-management-revisions) enable you make and test changes to your API without affecting consumers. For each revision, you can view the revision ID, date created, description, URL, and Postman source.

  * Use the **Online** toggle to set a revision to offline or online. Consumers can't access an offline revision.
  * Use the **Current** toggle to make a revision the current revision for your API. Enter an optional description and click **Confirm**. Consumers access the current revision when calling the API.

* **Changelog** - The changelog shows the deployment history for your API. Each time you make a revision current, Postman adds an entry to the changelog, including the date created, the date last updated, and a description of the change.

* **Export History** - The export history lists all exports from Postman for this API. For each export, you can view the date created, the Azure revision, and the Postman source.

<img alt="Viewing a service instance" src="https://assets.postman.com/postman-docs/v10/azure-apim-view-a-service-v10.jpg" />

From the service details view, you can take the following actions:

* Use the dropdown list to view a different Azure API Management service instance.
* To export your definition to Azure, click **Export API**. Learn more about [exporting your API](#export-your-api-to-azure-api-management).
* To import a definition from Azure, click **Import Definition**. Learn more about [importing a definition](#import-a-definition-from-azure).
* To see the latest deployment status, click <img alt="Refresh icon" src="https://assets.postman.com/postman-docs/aether-icons/action-refresh-stroke.svg#icon" width="16px" /> **Refresh**.
* To edit or delete the connection to Azure API management, click <img alt="Options icon" src="https://assets.postman.com/postman-docs/aether-icons/action-options-stroke.svg#icon" width="16px" /> **View more actions**.
* To open the gateway URL of the API management service, select the **Gateway URL** link.
* To open the developer portal for the API management service, click **View Developer Portal**.

## Import a definition from Azure

You can import a definition from a connected Azure API Management service to your API in Postman. *Importing a definition will replace your current API definition or add a new definition if one doesn't exist.*

1. Click **APIs** in the sidebar and select an API.
2. Click **Deployments**, then click **Import Definition**.
3. Select the **Definition type** (OpenAPI 2.0 or OpenAPI 3.0).
4. Select the **Azure service** to import the definition from.
5. Click **Import**.

<img alt="Importing a definition" src="https://assets.postman.com/postman-docs/v10/azure-apim-import-schema-v10.jpg" />

## Export your API to Azure API Management

Exporting an OpenAPI definition makes it available in the connected Azure API Management service. OpenAPI 2.0 and 3.0 definitions are supported. You can export the definition to an existing revision or to a new revision.

1. Click **APIs** in the sidebar and select an API.

2. Click **Deployments**.

3. Select the service you want to export to, then click **Export API**.

4. Select the source of the definition you want to export. You can select the current definition or any [published version](/docs/design-apis/api-builder/versioning-an-api/api-versions/) of the definition.

5. Enter a brief description for the export.

6. (Optional) If you want to export the definition to an existing revision, select the checkbox. Select the **Revision ID** of the revision you want to update.

   <Info class="iconless-callout">
     If you don't select the checkbox, Postman exports the API to a new revision.
   </Info>

7. Click **Export**.

<img alt="Exporting an API" src="https://assets.postman.com/postman-docs/v10/azure-apim-export-v10.jpg" />

After exporting, you can use the **Current** toggle to make the new or updated revision the current revision.

### Troubleshoot export issues

If you have problems exporting your definition, check the following:

* Some definition fields (such as name, description, and protocols) must be updated on the current revision and can't be updated on other revisions. To update these fields on revisions that aren't the current revision, perform a manual merge instead.

* Some properties of the OpenAPI specification aren't supported by Azure API Management. For more information, see the Microsoft help article [API import restrictions and known issues](https://docs.microsoft.com/en-us/azure/api-management/api-management-api-import-restrictions).