For the complete documentation index, see llms.txt. This page is also available as Markdown.
Developers / IT teams
URLs and IP address ranges to whitelist
To ensure FormSG functions properly in your network environment, specific URLs and IP addresses may need to be whitelisted in your organisation's firewall or proxy settings.
You can do this by going into your form and clicking on the "Share" button on the top right. Then click on "Embed".
If you embed FormSG within your site using an iframe, any form responses will still be sent to the form admin. The form responses cannot be 'intercepted' by the parent website hosting the iframe.
We don't have guidelines for how to embed the form into your website as the look and feel would differ between websites. It is not necessary to set the sandbox attribute as the website you are embedding is FormSG, not an external untrusted third party site.
Does FormSG team provide direct support for setting up webhooks?
We currently do not provide direct support for setting up the webhooks as this can be mostly self served using our SDK.
We may assist to help answer some of your queries and investigate set-up issues but this will not be considered an urgent priority.
Why is FormSG attempting a retry even though our system has processed it successfully?
Our webhooks require an acknowledgement (a HTTP 200 OK response) within 10 seconds. If the acknowledgement is delayed or missing, FormSG might retry sending it because it assumes a failure.
Example of this is becoming an issue is when your system performs other tasks (such as sending out emails) before acknowledging the webhook. The best practice is to acknowledge the webhook on receipt.
