Loading
Upcoming Mandatory Changes to Public Key Infrastructure (PKI)Read More
Salesforce Enforces New Security Requirements in Summer 2026Read More

Hitting the Health Cloud FHIR API Returns 401 Unauthorized or Something went wrong errors

Publish Date: Jul 6, 2026
Description

When making calls to the Health Cloud FHIR API, you may encounter a 401 Unauthorized error or a generic "Something went wrong" error, even when the access token is generated successfully and all the configuration steps documented in the Help article have been completed.

This article provides additional troubleshooting steps for resolving these errors when invoking the Health Cloud FHIR APIs. 

Resolution

Please follow the steps below and verify whether they resolve the issue.

  1. Validate the org and integration configuration by following the below article.

    Enable Access to Industry APIs
    Integration Solutions with MuleSoft
    Authorization

  2. Verify if the OAuth Custom Scopes are configured as outlined in the Health Cloud Authorization Documentation
  3. Verify if the FHIR R4 Support Settings are enabled, OAuth token generation succeeds, the connected app and running user have API access, and the authorization scopes match a working environment.
  4. If the issue persists, refresh consent for the Industry APIs integration. In Setup, go to Quick Find, search for Integration > MuleSoft > Industry APIs, open Terms, uncheck the consent checkbox and save, refresh the page, then return to Terms, re-check the consent checkbox, and save again.
  5. If consent refresh does not resolve the error, check if the “Introspect All Tokens” option for the external client application is enabled. If not, please enable it and then retest the FHIR endpoint. This is a required prerequisite for all Health Cloud FHIR API calls.
Knowledge Article Number

005388352

 
Loading
Salesforce Help | Article