Edit

Share via


Use deep links with the Power Apps mobile app

Deep links let users move from one application to another on computers and mobile devices. Simple examples include a mobile app deep-linking to Facebook to sign in, an email address deep-linking to a mail app to compose a message, or a website deep-linking to an app store to download a related mobile app.

You can open an entityrecord or an entitylist view in the Power Apps mobile app by using deep-link URLs from other apps. When you follow the link from an external app, the target element opens in Power Apps mobile

If you're already signed in to your instance in the app, the target record is displayed when you follow the link from an external app. Otherwise, you're prompted to sign in to your instance in the mobile app; after you're signed in, the target element is displayed. You must have the Power Apps mobile app installed on your mobile device to use this feature.

Supported Urls parameters for a model-driven app

Use the following application handler and query string parameters to compose the URL.

Deep links for the Power Apps mobile app should start with the following:

ms-apps://<org-url>_<app-id>?tenantId=<tenant-id>&appType=AppModule&openApp=true&restartApp=true&forceOfflineDataSync=true

Important

The org-url can't contain https://. The following is a example of a model-driven app deeplink:
ms-apps://contoso.onmicrosoft.com_e6429eba-2204-40e8-b9dd-fc74791ff2c2?tenantId=219f9bd4-8c16-4dfa-b87e-f4a33764f1dd

Parameter Description Required
<targeted-app>
  • ms-dynamicsxrm -> Dynamics 365 for phones
  • ms-apps-fs -> Field Service
  • ms-apps -> Power Apps
  • ms-mobile-apps -> wrapped native mobile apps
Yes
<org-url> Connects to the correct org URL. Yes
<app-id> Opens the correct app module. Yes
tenantId=<tenand-id> Connects to the correct tenant. Yes
appType=AppModule Indicates that the targeted app is a model-driven app. Yes
restartApp=true Restarts the model-driven app. Required to ensure parameters are passed when the app is already open. No
forceOfflineDataSync=true Ensures that data sync is triggered so that all the latest data is available. No

If opening an entityrecord form or creating a new entityrecord, use the following parameters:

Parameter Description Required
etn=<entity-logical-name> Designates which table to go to. Yes
pagetype=entityrecord Indicates that the target is a form. Yes
id=<record-id> Designates which specific record to go to; if left blank, the create form for the table opens. Yes
extraqs=<form-id> Designates which form to open for the entityrecord; if not specified, the default form opens. The extraqs parameter can also be used to default field values. No

If the link goes to an entitylist view, add the following parameters:

Parameter Description Required
etn=<entity-logical-name> Designates which table to go to. Yes
pagetype=entitylist Indicates that we're going to a view. Yes
viewid=<view-id> Designates which view to open. No
Viewtype= <1039 if system view, 4230 if personal view> Indicates whether the targeted view is a system view or a personal view. No

Supported Urls parameters for a canvas app

ms-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Parameter Description Required
<app-id> Opens the correct app module. Yes
tenantId=<tenantId> Connects to the correct tenant. Yes
restartApp=true Restarts the model-driven app. Required to ensure parameters are passed when the app is already open. No
autoLoginUpn=<e-mail> Autopopulates e-mail and triggers sign-in. No

Supported Urls parameters for a wrapped native mobile app

ms-mobile-apps:///providers/Microsoft.PowerApps/apps/<appID>?tenantId=<tenantId>&restartApp=true

Parameter Description Required
<app-id> Opens the correct app module. Yes
tenantId=<tenantId> Connects to the correct tenant. Yes
restartApp=true Restarts the model-driven app. Required to ensure parameters are passed when the app is already open. No
autoLoginUpn=<e-mail> Autopopulates e-mail and triggers sign-in. No

Troubleshooting

Deeplinks may open in your browser depending on the company's organizational policies and the user's device settings. Mobile Device Management (MDM) tools and device operating systems have different options and settings that impact how deeplinks are handled. If deeplinks are opening in a browser instead of directly in Power Apps mobile, make sure your MDM policies and device settings are appropriately configured.

As an example, on some Android devices, go to Settings > Apps > Power Apps > Open by default and add apps.powerapps.com to make deeplinks open directly in Power Apps mobile.