Form Personalization

Prev Next

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 Forms menu and select form.

  2. Navigate to the Developer Tools tab Developer Tools tab.

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

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

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

  4. Scroll up and click Save Save workflow.