Form Personalization

There is often a need to be able to personalize the content of the form based on the logged-in user. This feature allows developers to add data to the form to account for that. For example, this can be used to add content to the form based on who the logged-in user is.

This feature has been used to prepopulate specific elements on a form with the content that was entered by that user on their most recent submission. This removed the need for the users to enter that information every time they completed the form, saving them a significant amount of time.

Custom URL and Hosted API

At the moment, Personalization is only available using API. You can configure your Personalisation endpoint using Custom URL or API Hosting.

Below is a type definition of the request payload:

{ formsAppId: numberformId: numberexternalIdUrlSearchParam: string | nulldraftId: string | nullpreFillFormDataId: string | nulljobId: string | nullpreviousFormSubmissionApprovalId: string | null}

Below is a type definition of the response payload:

{ submission?: { [formElementName]: any } elements: FormElement[]}

Instructions

1. Navigate to the Forms tab and select the applicable form or create a new form

2. Navigate to the Developer Tools tab

3. On the Personalization section and choose Custom URL or Hosted API

   • Custom URL: Enter the URL address for an API endpoint

   • Hosted API: Select a Hosted API you have created and a Route from the drop-downs

4. Scroll up and click Save