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.
Supported deep links in the Power Apps 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:
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.
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.
Do you want to create apps to help make your business more efficient? Then, this path is for you. It introduces you to Power Apps, helps you create and customize an app, and then manage and distribute it.