Pre-fill an eForm using URL parameters

Necessary Therefore™ applications:
  • Therefore™ eForms web interface

It is possible to have fields in an eForm pre-filled by including specific parameters into the URL linking to it.
An eForm URL should be in the following format:

Copy
https://[TenantName].thereforeonline.com/eForms/#/embed/[Form_Number]


To have an eForm field pre-filled, users will need to go to the eForms web interface and open the eForm in question in edit mode.

Find the field that should be pre-filled and click the 'Edit' button to see the component's configuration. Go to the API tab, and make note of the value of the field labeled 'Property Name'.

Returning to the URL, add a '?' after the path to introduce a query parameter. Add the 'Property Name' as the query parameter name. Specify the desired value for the field by adding '=value'.

A pre-filled eForm URL will look like this:

Copy
https://[TenantName].thereforeonline.com/eForms/#/embed/[Form_Number]?[PropertyName]=[Value]

In the example below, the URL is altered to pre-fill one field, and then two fields.

In the following example, the form number is 137 and the 'Property Name' is 'textField2'. The value of the field is specified to be 'Monty Palin'.

If this information is added as a query parameter, it should result in the following URL:

Copy
https://moyawarefinance.thereforeonline.com/eForms/#/embed/137?textField2=Monty%20Palin
Info Icon

Note:
Use '%20' when blank spaces are necessary.

Multiple query parameters can be introduced by adding an ampersand ('&') between them.

Typing an "&" after a parameter allows the user to add more parameters. In this example, another field with the property name 'number2' is set to be pre-filled with the value '7'.

Adding this query parameter results in the following sample URL:

Copy
https://moyawarefinance.thereforeonline.com/eForms/#/embed/137?textField2=Monty%20Palin&number2=7
Info Icon

Note:
The property name for each field in the URL is case sensitive and should be copied to match what is found in the API tab exactly.