Quickstart: Deploy Azure API for FHIR using Azure portal

In this quickstart, you'll learn how to deploy Azure API for FHIR using the Azure portal.

If you don't have an Azure subscription, create a free account before you begin.

Create new resource

Open the Azure portal and click Create a resource

Create a resource

Search for Azure API for FHIR

You can find Azure API for FHIR by typing "FHIR" into the search box:

Search for Healthcare APIs

Create Azure API for FHIR account

Select Create to create a new Azure API for FHIR account:

Create Azure API for FHIR account

Enter account details

Select an existing resource group or create a new one, choose a name for the account, and finally click Review + create:

New healthcare api details

Confirm creation and await FHIR API deployment.

Additional settings

Click Next: Additional settings to configure the authority, audience, identity object IDs that should be allowed to access this Azure API for FHIR, enable SMART on FHIR if needed, and configure Cosmos DB throughput:

  • Authority: You can specify different Azure AD tenant from the one that you are logged into as authentication authority for the service.
  • Audience: You can specify audience, that is different from https://azurehealthcareapis.com.
  • Allowed object IDs: You can specify identity object IDs that should be allowed to access this Azure API for FHIR
  • Smart On FHIR proxy: You can enable SMART on FHIR proxy. For details on how to configure SMART on FHIR proxy see tutorial Azure API for FHIR SMART on FHIR proxy
  • Cosmos DB throughput: Azure API for FHIR relies on Cosmos DB as its underlying database. Here you can specify Cosmos DB throughput settings for your Azure API for FHIR. You can change this setting later in the Cosmos DB blade. For details on Cosmos DB RUs please read Request Units in Azure Cosmos DB

Configure allowed object IDs

See how to find identity object IDs for details on how to locate identity object IDs for users and service principals.

Fetch FHIR API capability statement

To validate that the new FHIR API account is provisioned, fetch a capability statement by pointing a browser to https://<ACCOUNT-NAME>.azurehealthcareapis.com/metadata.

Clean up resources

When no longer needed, you can delete the resource group, Azure API for FHIR, and all related resources. To do so, select the resource group containing the Azure API for FHIR account, select Delete resource group, then confirm the name of the resource group to delete.

Next steps

In this tutorial, you've deployed the Azure API for FHIR into your subscription. To set additional settings in your Azure API for FHIR, proceed to the additional settings tutorial.