Scenario: Mobile application that calls web APIs

Learn how to build a mobile app that calls web APIs.


Before reading this article, you should be familiar with the following concepts:

Getting started

Create your first mobile application and try out a quickstart.


A personalized, seamless user experience is essential for mobile apps. Microsoft identity platform enables mobile developers to create that experience for iOS and Android users. Your application can sign in Azure Active Directory (Azure AD) users, personal Microsoft account users, and Azure AD B2C users. It can also acquire tokens to call a web API on their behalf. To implement these flows, we'll use Microsoft Authentication Library (MSAL). MSAL implements the industry standard OAuth2.0 authorization code flow.

Daemon apps

Considerations for mobile apps:

  • User experience is key: Allow users to see the value of your app before you ask for sign-in. Request only the required permissions.
  • Support all user configurations: Many mobile business users must adhere to conditional-access policies and device-compliance policies. Be sure to support these key scenarios.
  • Implement single sign-on (SSO): By using MSAL and Microsoft identity platform, you can enable single sign-on through the device's browser or Microsoft Authenticator (and Intune Company Portal on Android).
  • Implement shared device mode: Enable your application to be used in shared-device scenarios, for example hospitals, manufacturing, retail, and finance. Read more about supporting shared device mode.


Keep in mind the following considerations when you build a mobile app on Microsoft identity platform:

  • Depending on the platform, some user interaction might be required the first time that users sign in. For example, iOS requires apps to show user interaction when they use SSO for the first time through Microsoft Authenticator (and Intune Company Portal on Android).
  • On iOS and Android, MSAL might use an external browser to sign in users. The external browser might appear on top of your app.
  • Never use a secret in a mobile application. In these applications, secrets are accessible to all users.

Next steps