# Forms Api - Captcha Handling

**URL:** <https://community.hubspot.com/t/forms-api-captcha-handling/12595>\
**Category:** APIs & Integrations\
**Tags:** forms\
**Created:** [December 18, 2018, 7:52pm UTC](https://community.hubspot.com/t/forms-api-captcha-handling/12595 "2018-12-18T19:52:09Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![avolk](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/avolk/32/14279_2.png) [@avolk](https://community.hubspot.com/u/avolk)\
**Post date:** [December 18, 2018, 7:52pm UTC](https://community.hubspot.com/t/forms-api-captcha-handling/12595/1 "2018-12-18T19:52:09Z")

</div>

I am currently using the v2 Forms API, but ran into an issue where forms with captcha enabled returns an error.

Switching to v3 does not seem to return an error if captcha is enabled – which is good – but, since captcha handing is not mentioned in either the v2 or v3 documentation I’m not sure if this is what’s intended.

I am hoping to get confirmation that this is the intended result and it will not break in the future. Any information would be helpful.

Thanks!

---

<div class="post-metadata">

**Author:** ![IsaacTakushi](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/isaactakushi/32/70387_2.png) [@IsaacTakushi](https://community.hubspot.com/u/IsaacTakushi)\
**Post date:** [December 19, 2018, 6:26pm UTC](https://community.hubspot.com/t/forms-api-captcha-handling/12595/2 "2018-12-19T18:26:41Z")

</div>

Hey, [@Adam\_Volkman](https://community.hubspot.com/u/adam_volkman).

I’ve only found one other topic reporting reCAPTCHA issues with the v2 Forms API. Does [this](https://integrate.hubspot.com/t/captcha-in-hubspot-forms-api/1475) sound like the issue you encountered? If so, what error was returned? Can you send me a link to the HubSpot form you were testing?

I don’t have specific insight into reCAPTCHA-related support in the v3 Forms API, but it was designed to be more flexible and powerful than the second version. Since it’s in stable release, I can confirm the team doesn’t plan to make any major updates to it, so the behavior you’re seeing should not change in the future.

---

<div class="post-metadata">

**Author:** ![avolk](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/avolk/32/14279_2.png) [@avolk](https://community.hubspot.com/u/avolk)\
**Post date:** [December 19, 2018, 7:14pm UTC](https://community.hubspot.com/t/forms-api-captcha-handling/12595/3 "2018-12-19T19:14:57Z")

</div>

Thanks [@Isaac\_Takushi](https://community.hubspot.com/u/isaac_takushi).

Yes, that appears to be the same issue we ran into. Sorry for the lack of detail - I was mostly concerned with the new api. Here is the html response we received when trying to submit to a form with reCAPTCHA enabled.

[

 ![](https://d2qpr2jzcazej7.cloudfront.net/original/3X/e/d/ed740712f5fdfa034d36c2198f81412ce87f6b40.png)

image.png1792×1054 93.5 KB

]([https://community.hubspot.com/legacyfs/online/uploads/default/original/2X/d/dbefa1a4577f4e6f10e56f0f8df5c82148d89438.png](https://community.hubspot.com/legacyfs/online/uploads/default/original/2X/d/dbefa1a4577f4e6f10e56f0f8df5c82148d89438.png))

It appears there’s no support for this, since it says “If you’ve manually integrated this form, please turn off reCaptcha”. If that’s the case, it’s fine, but I would recommend noting this restriction somewhere in the api documentation. It could help avoid some confusion for developers in the future.

Upgrading to the v3 Api works for us as a solution and I’m glad to hear it should continue to work with reCAPTCHA enabled forms. Again, it would be helpful to note in the docs that reCAPTCHA will be ignored for api submissions (or however the api handles it). When working with APIs it’s not ideal to have to make assumptions, since it can come back to bite you – as it did for us  
 ![sweat_smile.png](https://d2qpr2jzcazej7.cloudfront.net/original/3X/6/2/620cc3e43806cdbd91dbb13831d11c91f33f0886.png)

Thanks again for your help!

---

<div class="post-metadata">

**Author:** ![IsaacTakushi](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/isaactakushi/32/70387_2.png) [@IsaacTakushi](https://community.hubspot.com/u/IsaacTakushi)\
**Post date:** [December 19, 2018, 7:29pm UTC](https://community.hubspot.com/t/forms-api-captcha-handling/12595/4 "2018-12-19T19:29:35Z")

</div>

Thanks for the feedback, [@Adam\_Volkman](https://community.hubspot.com/u/adam_volkman)! This is super helpful. We’re actually in the middle of auditing all of our developer documentation so I will make a note to have reCAPTCHA mentioned (I personally never knew this v2 restriction existed).

---

<div class="post-metadata">

**Author:** ![mdare\_usablenet](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mdare_usablenet/32/27794_2.png) [@mdare\_usablenet](https://community.hubspot.com/u/mdare_usablenet)\
**Post date:** [February 27, 2020, 10:31am UTC](https://community.hubspot.com/t/forms-api-captcha-handling/12595/5 "2020-02-27T10:31:08Z")

</div>

Hello,

I tried to upgrade to v3 but I still received the reCAPTCHA error message by API

```auto
errors": [
 {
 "message": "Form ' ********' can't receive API submissions as Captcha (SPAM prevention) is enabled.",
 "errorType": "FORM_HAS_RECAPTCHA_ENABLED"
 }
 ],

```

By the previous comments, I understood the v3 works with reCAPTCHA enabled but I don’t know what I wrong. Could you help me?

URL [https://api.hsforms.com/submissions/v3/integration/submit/:\*\*\*/:\*\*\*](https://api.hsforms.com/submissions/v3/integration/submit/: ***/:*** )

BODY:

```auto
{
 "submittedAt": "1582798776000",
 "skipValidation": true,
 "fields": [
 {
 "name": "firstname",
 "value": "test"
 },
 {
 "name": "lastname",
 "value": "test"
 },
 {
 "name": "company",
 "value": "Test"
 },
 {
 "name": "email",
 "value": " ****"
 }
 ],
 "context": {
	"hutk": " ***********",
 "pageUri": "test.com",
 "pageName": "test page", "ipAddress": " **.**. **.**"
 }
}

```

Thanks,

Marco

---

<div class="post-metadata">

**Author:** ![soydiaz](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/soydiaz/32/5125_2.png) [@soydiaz](https://community.hubspot.com/u/soydiaz)\
**Post date:** [March 19, 2020, 11:33pm UTC](https://community.hubspot.com/t/forms-api-captcha-handling/12595/6 "2020-03-19T23:33:43Z")

</div>

I have the same problem, I have tried to migrate to v3, but it returns the following message.

“can’t receive API submissions as Captcha (SPAM prevention) is enabled.”,  
“errorType”: “FORM\_HAS\_RECAPTCHA\_ENABLED”