Quickstart: Create a new Azure API Management instance by using the Azure portal
APPLIES TO: All API Management tiers
This quickstart describes the steps for creating a new API Management instance using the Azure portal. After creating an instance, you can use the Azure portal for common management tasks such as importing APIs in your API Management instance.
Azure API Management helps organizations publish APIs to external, partner, and internal developers to unlock the potential of their data and services. API Management provides the core competencies to ensure a successful API program through developer engagement, business insights, analytics, security, and protection. With API Management, create and manage modern API gateways for existing backend services hosted anywhere.
If you don't have an Azure subscription, create an Azure free account before you begin.
Sign in to Azure
Sign in to the Azure portal.
Create a new instance
From the Azure portal menu, select Create a resource. You can also select Create a resource on the Azure Home page.
On the Create a resource page, select Integration > API Management.
On the Create API Management page, on the Basics tab, enter settings.
Setting Description Subscription The subscription under which this new service instance will be created. Resource group Select a new or existing resource group. A resource group is a logical container into which Azure resources are deployed and managed. Region Select a geographic region near you from the available API Management service locations. Resource name A unique name for your API Management instance. The name can't be changed later. The service name refers to both the service and the corresponding Azure resource.
The service name is used to generate a default domain name: <name>.azure-api.net. If you would like to configure a custom domain name later, see Configure a custom domain.Organization name The name of your organization. This name is used in many places, including the title of the developer portal and sender of notification emails. Administrator email The email address to which all system notifications from API Management will be sent. Pricing tier Select a tier with the features you need. The Basic v2 tier is an economical choice for development and testing scenarios and is deployed in a few minutes. Units The number of units of capacity for the selected pricing tier. For evaluating API Management, you can accept the default value of 1 unit. On the Monitor + secure tab, optionally select one or more recommended add-in services to use with API Management. These services incur extra costs. For example, select Log Analytics to define a Log Analytics workspace you can target for API Management logs.
On the Managed identity tab, we recommend selecting the checkbox to enable a system-assigned identity for your API Management instance. A managed identity generated by Microsoft Entra ID allows your API Management instance to easily and securely access other Microsoft Entra protected resources, such as Azure Key Vault. Azure manages this identity, so you don't have to provision or rotate any credentials.
Optionally, on the Tags tab, add tags to your API Management instance. Tags are key-value pairs that help you organize and manage your Azure resources.
On the Review + install tab, review the settings you selected. If you need to make changes, go back to the previous tabs. If everything looks good, select Create.
Go to your API Management instance
In the Azure portal, search for and select API Management services.
On the API Management services page, select your API Management instance.
Review the properties of your service on the Overview page.
When your API Management service instance is online, you're ready to use it. Start with the tutorial to import and publish your first API.
Clean up resources
When no longer needed, you can remove the resource group and all the related resources by following these steps:
In the Azure portal, search for and select Resource groups. You can also select Resource groups on the Home page.
On the Resource groups page, select your resource group.
On the resource group page, select Delete resource group.
Type the name of your resource group, and then select Delete.
