topic Re: Would using the v3 embed link be an issue? (instead of v2) in APIs & Integrations

Would using the v3 embed link be an issue? (instead of v2)

ONg — Fri, 03 Mar 2023 08:33:48 GMT

The embed for a form is as such:

... Just wondering instead of using //js.hsforms.net/forms/embed/v2.js, would using //js.hsforms.net/forms/embed/v3.js be ok?

Context: We embedded the form with no issues as an iframe, but we need it as a raw HTML form instead. After switching it to a HTML form, the captcha on the form stopped working.

Stumbled upon this post: https://community.hubspot.com/t5/APIs-Integrations/Forms-Api-Captcha-Handling/m-p/248800 ... tried the v3 link and it worked properly. Contacted Hubspot Support to see if it's a viable solution, and they told me to ask the question here instead so here I am.

Would this v3 link be okay?

Re: Would using the v3 embed link be an issue? (instead of v2)

p6l-richard — Tue, 08 Apr 2025 15:40:30 GMT

I think so.. looks like the form will try to fetch `/embed/v3/form/<portal_id>/<form_id>/json` and that errors:

I just received this response:
```json
{
"status": "error",
"message": "You cannot fetch this type of form using this endpoint. Not an Embed version 2 or 3 form",
"correlationId": "a408499a-..."
}
```

Although it does render the form somehow.

Re: Would using the v3 embed link be an issue? (instead of v2)

SApostolov — Wed, 14 Jan 2026 17:34:40 GMT

I have the same problem,
Did support help you?

Re: Would using the v3 embed link be an issue? (instead of v2)

BérangèreL — Mon, 19 Jan 2026 09:40:34 GMT

Hi @SApostolov and thanks for your question!

As of now, the documentation only references //js.hsforms.net/forms/embed/v2.js as the standard embed script URL, there isn’t any official guidance about using v3 at this time.

Regarding CAPTCHA, there are some limitations when handling CAPTCHA with raw HTML forms and the Forms API.

Form submissions via the API that include CAPTCHA tokens may return errors, so we recommend implementing your own spam protection system before sending data through the API.

Hi @Anton, @MichaelMa and @SteveHTM, what are your thoughts on this, please?

Thanks so much and have a lovely day!
Bérangère

This post was created with the assistance of AI tools

Re: Would using the v3 embed link be an issue? (instead of v2)

ONg — Mon, 19 Jan 2026 10:40:36 GMT

Support didn't help me, but I went ahead and used v3 anyway with no problems. At your own risk. We monitored the form closely to make sure there weren't any issues and it was ok until we switched to the newer form.

Re: Would using the v3 embed link be an issue? (instead of v2)

Anton — Mon, 19 Jan 2026 11:28:39 GMT

As far as I know:

V2 is for forms built with what's being called "Legacy forms" now, while v4 (there's no official v3) is for the new form editor.

If you want to get the raw HTML of a legacy form, you can modify the embed code slightly from

By adding the css:"", the form is being rendered as plain HTML without any inherited styles from HubSpot.

Hope this helps

best,

Anton