Create a deep link into the Mobile Locker app

A deep link opens the Mobile Locker app to a file, a folder, Content Home, or email compose. The same URL works on iPhone, iPad, Windows, and Android.

You can copy a ready-made App URL from a presentation or a folder. You can also build the same URL for a CRM or call app (for example CATS, Veeva CRM, or Salesforce).

Copy a presentation App URL

1. Open the presentation in the admin site.
2. Find Open & email URLs.
3. Copy App URL.
4. Paste it into email, Slack, Teams, a CRM button, or any app that can launch a custom URL.

Those three fields are not the same:

This article is about the App URL.

Copy a folder App URL

1. Open the folder in the admin site.
2. Find Share Links.
3. Copy Native App Folder URL.
4. Paste it the same way you paste a presentation App URL.

Those two fields are not the same:

URL shape

Every app deep link looks like this:

mobilelocker://x-callback-url/{action}?key=value

Replace the example IDs below with IDs from your team. You can copy those IDs from the App URL on the presentation or folder page.

Open a presentation

mobilelocker://x-callback-url/open-presentation?presentation_id=2313

The person who taps the link must have access to that file. If they do not, the app tells them they do not have access.

Open a folder

mobilelocker://x-callback-url/open-folder?folder_id=5122

The app opens that folder in Content. It does not open a file. If the person does not have that folder, the app tells them they do not have access.

Open Content Home

mobilelocker://x-callback-url/open-main

Use this when you want to bring the person into Mobile Locker without opening a specific file. You can still add CRM or CATS parameters (see below).

Open email compose

mobilelocker://x-callback-url/compose-email?presentation_id=2313&list_id=7

All of these parameters are optional. A link with no parameters opens a blank compose screen:

• contact_id
• list_id (if both a contact and a list are present, the list is used)
• presentation_id
• template_id

The person must have permission to send email. A compose link cannot bypass that setting.

The presentation Shareable email URL is browser compose. It is not this app deep link.

CRM and CATS parameters

You can add extra query parameters to any of the URLs above. The app keeps those values with the visit so your CRM or call system can match the activity.

Synergistix CATS

Use this pattern when a call screen should open Mobile Locker and attach the call:

mobilelocker://x-callback-url/open-presentation?x-source=CATS&presentation_id=2313&cats_call_id=222&cats_entity_id=333

Open Content Home and still attach the call:

mobilelocker://x-callback-url/open-main?x-source=CATS&cats_call_id=222&cats_entity_id=333

Include both cats_call_id and cats_entity_id. Other cats_* keys can ride on the same URL.

Veeva CRM or Salesforce

To select a CRM customer before the file or folder opens, include both:

• crm_related_object (for example Account or Contact)
• crm_related_id

You can also add crm_related_object_name as a display name if the record is not on the device yet. One of those keys alone is ignored.

mobilelocker://x-callback-url/open-presentation?presentation_id=2313&crm_related_object=Contact&crm_related_id=003XXXXXXXXXXXXXXX&crm_related_object_name=Jane%20Doe

The same pair works on open-folder and open-main.

Devices and apps

Use the same mobilelocker:// URL from:

• iPhone or iPad (Mobile Locker iOS app)
• Windows PC (current Windows app, version 5)
• Android phone or tablet (Mobile Locker Android app)
• A CRM or call app that can launch a custom URL (CATS, Veeva, Salesforce)
• A message the person taps in email, Slack, or Teams, if that client launches custom URLs

The Mobile Locker app must be installed. The person must sign in. If they tap the link before they sign in, the app waits and then opens the file, folder, home, or compose screen after sign-in.

What happens when someone taps