Deep Link

The integration schemes described on this page, allows you to: 

• Open Form.com mobile or Windows desktop app from any external source - website or another application;

• Pass a set of parameters and open a form on a mobile application with pre-filled data;

• Launch externally Task Definitions, Task Management, Tasks, or Forms attached to Tasks.

You cannot use the Deep Link function unless a Form.com mobile application is installed on your device. Please read the article for more details.

The article covers 2 types of schemes and URL templates for the above mentioned cases.

2 Types of Links

Form.com application deep linking may be implemented using 2 schemes supported by iOS, Android, and Windows operating systems:

Universal links - https://launch.form.com

If universal links are supported, users can tap a link on a website or in another application and get redirected to Form.com application if it is installed on a device. Otherwise, users will be prompted to download and install the app.

Custom links - launch.form.com:// 

Although this is the legacy scheme for older OS versions, it is still supported and widely used. This method has lower minimal system requirements but is lacking system feedback when the application is not installed. If your respondents use both Mobile apps and Windows Desktop app, it is preferable to use this scheme, as you will need to compose only 1 link. 

Custom / Universal links system requirements 

Please note that that the Universal and Custom Links will not launch the Mobile App if you insert them directly into the address bar of a browser.

URL Templates

URL Templates for viewing/editing existing Responses or creating new ones

This URL templates allow opening pre-populated forms. The links should be created by you and added to the external application/website code for Form.com mobile app to be launched. 

Link structure:

{prefix}/server/{customer_server_base_url}/portal/{portal_id}/nosync|sync/forms/{form_id}/view (/{response_id}) | edit (/{response_id}) | new (?{import_param_prefix}&{param1}={value_1}&{param_N}={value_N})

ℹ Example

HTTPS URL for Android and iOS:

https://launch.form.com/server/app.form.com/portal/123456/sync/forms/123456/view/123456789/ (viewing existing response)

Custom Scheme URL for Android, iOS and Windows:

launch.form.com://server/app.form.com/portal/123456/sync/forms/123456/new?LQID=1&Name=John&Age=25&Position=Developer (creating a new response with prefilled info)

These links have additional parameters which allow to determine whether you want to view or edit existing responses, or create a new one with prefilled information.

Parameters used in the link: 

URL Import may be used only when creating new responses.

URL Templates for launching the Tasks or Forms attached to Tasks

The link structures described below make it possible to trigger the launch of a Task Definition, Task Management, Tasks, or Forms attached to Tasks from an external source. 

Link structure:

{prefix}/server/{customer_server_base_url}/portal/{portal_id}/nosync|sync/tasks/{task_definition_id}/admin_view|task_view/{task_id}/form?{import_param_prefix}&{param1}={value_1}&{param_N}={value_N}

 ℹ Example

HTTPS URL for Android and iOS:

https://launch.form.com/server/app.form.com/portal/123456/sync/forms/123456/view/123456789/ (viewing existing response)

Custom Scheme URL for Android, iOS and Windows:

launch.form.com://server/app.form.com/portal/123456/sync/forms/123456/new?LQID=1&Name=John&Age=25&Position=Developer (creating a new response with prefilled info)

These links may also include custom URL Import parameters to prefill form questions.

Parameters used in the link:

URL Templates for launching the App and opening a pre-populated Form

These are alternative link structures for opening pre-populated forms. These links may also include custom URL Import parameters to prefill application fields and form questions.

Link structure:

{prefix}/server/{customer_server_base_url}/portal/{portal_id}/form/{form_id}/{import_param_prefix}&{param_1}={value_1}&{param_N}={value_N}

ℹ Example

HTTPS URL for Android and iOS:

https://launch.form.com/server/app.form.com/portal/123456/form/1234567/?LQID=1&Name=John&Age=25&Position=Developer

Custom Scheme URL for Android, iOS and Windows:

launch.form.com://server/app.form.com/portal/123456/form/1234567/?LQID=1&Name=John&Age=25&Position=Developer

These links may also include custom URL Import parameters to prefill application fields and form questions.

Parameters used in the link:

• prefix;

For Universal Links the prefix consists of scheme_type https:// and register_domain launch.form.com Form.com applications respectively.

For Custom Scheme URLs the prefix consists of scheme_type launch.form.com://

• server, portal, form -  Server URL, Portal ID and Form ID that should be opened;

• import_param_prefix - Static system parameter to identify the start of custom parameters list. The value for this parameter is ‘?LQID=1’;

• param_1=value_1; param_N=value_N - URL import parameters with values to prefill;

• 'offline_' + {ID} - use this parameter in case the Respondent ID is unknown.

The following values must not be used as parameter names:  onunload, validateTime, ARGS, LQID, i_n_f, Dir, surveyID, CharsetLine, goNextPage.y, goNextPage.x, RID, SID, RespondentID, pwd, pwd2, ALL_QIDS, EMAIL, WebPoll, SFObj, SFObjID, integrationSurveyID, ALL_COLUMNS, ALL_QUESTIONS, dispLinkId, globalFormID, logicPluginMenu, rspEmailAddress, startTime, VMOD