📃FormSG

This page explains the steps you need to follow to set up FormSG as a trigger for your pipe.

FormSG is a self-service, easy-to-use and feature rich form builder that enables public officers to collect citizen data quickly and securely. The best way to learn about FormSG is to login and create your first form.

The form you're connecting to needs to be a storage mode form. It can collect up to Restricted and Sensitive Normal data.

For more information about FormSG, click here!

Setting up FormSG

1. Upon clicking "Create pipe" on the homepage

2. Click on "Choose how you want your workflow to start"

3. Click on "FormSG"

4. Under "Choose connection", click the drop down

5. Click "Add new form"

6. Under "Form URL", paste the form link that you wish to connect to

7. Under "Form Secret Key", paste the form's secret key

8. Click "Connect"

9. A message "Your form is connected successfully." will be shown

10. Click "Save and continue"

11. Under "1. New form response", a green dot will appear as an indication that the form has been connected successfully.

1. Click "Check step"

2. You're done with setting up the FormSG integration!

Troubleshooting

FormSG Connect step

Error message	Explanation
We couldn't verify your webhook settings. Please try again later.	This could be due to one of these reasons: - your plumber account email is not registered with FormSG - your form credentials are invalid or form is not public - a server error on our side (contact us!)
The form you are trying to connect is currently being used in another pipe. Continuing with this connection will cause the other pipe to break.	Your form is currently connected to another pipe. Ensure that this current pipe is no longer in use before proceeding.
The form is currently connected to a different endpoint. Continuing with this connection will override this setting.	You may have set your form webhook endpoint to something else that is not a plumber webhook endpoint. Proceeding with this connection will no longer allow the current webhook endpoint to receive further submissions.

1) I am unable to retrieve the submitter's NRIC/FIN/UEN from my Singpass-enabled form

Forms created after 20 Aug 2024 will not collect NRIC/FIN/UENs by default. To enable this, make sure the following toggle "Collect NRIC/FIN/UENs with form submissions" is switched on under Settings > Singpass on your form.

2) I've added new questions to my form, but they're not showing up when I test my pipe. What's going on?

Following the update on 5 September 2024, new questions and responses will only appear after you unpublished your pipe and submit a new response. This ensures that your changes take effect.

1. Unpublished your pipe

2. Submit response with the new questions and response

3. Go back to your pipe.

4. Click "Test step" on Form

3) How can I better handle Table responses when using Plumber?

Always set a maximum number of rows in your form. This allows you to configure the automation for the highest possible number of rows. If a submission has fewer rows than the maximum, the automation will still function correctly.