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 database 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. You can learn more on finding the object id for users and service principals in the Find identity object IDs how-to guide.
  • 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
  • Provisioned throughput (RU/s): Here you can specify throughput settings for the underlying database for your Azure API for FHIR. You can change this setting later in the Database blade. For more details, please see the configure database settings page.

Configure allowed object IDs

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 quickstart guide, 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 how-to guide.