How to setup reCAPTCHA v3 for Form Handlers

Form Handlers collect data from your forms, then automatically create or update records within Insightly Marketing. reCAPTCHA is a free service developed by Google that helps protect websites from SPAM and abuse. It allows web hosts to distinguish between human and automated access to websites. Use reCAPTCHA v3 with Form Handlers to prevent SPAM Form submissions.

  • Requirements
  • Why use reCAPTCHA v3
  • How to setup reCAPTCHA v3


To start using reCAPTCHA, you need to sign up for an API key pair for your site. A key pair consists of a public key/site key and secret key.

Public key/Site key: A public key or site key is used to execute the reCAPTCHA service on your site or mobile application.

Secret key: A secret key authorizes communication between your application backend and the reCAPTCHA server to verify the user's response. The communication will occur once you have setup the JavaScript code on your site manually or if you have generated the Form HTML from the Form Handler record.

Do not share your secret key for security purposes.

Why use reCAPTCHA v3

Insightly users can setup reCAPTCHA to track the site’s traffic and understand how often their Forms receive submissions from potential bots and use the data to take appropriate actions for your site and to prevent abuse in the future.

reCAPTCHA learns by evaluating traffic on your site in real time. reCAPTCHA works best when you provide as much context about site interactions as possible. This comes from identifying both legitimate and abusive behavior.

After setup, reCAPTCHA v3 will return a score for each Prospect interaction with your Form. This will not interrupt your visitor’s experience, so you can run it at any time without affecting conversion.

The average score is based on your prospect's activity on your site. The score ranges from 0.0 to 1.0. 1.0 is most likely a positive interaction or good traffic. 0.0 is most likely a bot or abusive traffic.

How to setup reCAPTCHA v3

  1. Go to System Settings > Form Features.
  2. Under RECAPTCHA SETTINGS, enter your Public Key and your Secret Key.39f26fe4-e674-4bee-bbdd-7b578dede10c.png
  3. Click Save Settings.

If the reCAPTCHA Enabled field is checked on a Form Handler record, Insightly will generate additional code in the main JavaScript code to implement the reCAPTCHA feature on those Forms. This code can be found by clicking the Actions dropdown and selecting Generate Form HTML.

Was this article helpful?