# Form submission v3

**URL:** <https://community.hubspot.com/t/form-submission-v3/124678>\
**Category:** APIs & Integrations\
**Tags:** forms\
**Created:** [January 23, 2025, 8:48pm UTC](https://community.hubspot.com/t/form-submission-v3/124678 "2025-01-23T20:48:42Z")\
**Posts on this page:** 8\
**Page:** 1

<div class="post-metadata">

**Author:** ![Spinks](https://avatars.discourse-cdn.com/v4/letter/s/c68b51/32.png) [@Spinks](https://community.hubspot.com/u/Spinks)\
**Post date:** [January 23, 2025, 8:48pm UTC](https://community.hubspot.com/t/form-submission-v3/124678/1 "2025-01-23T20:48:42Z")

</div>

I’m working on integrating **Umbraco forms** with HubSpot to push form submissions into HubSpot forms via the API. I’ve come across the [v2 API documentation for form submissions](https://developers.hubspot.com/docs/reference/api/marketing/forms/v2#submit-data-to-a-form), which seems to provide a way to send form submissions.

However, I noticed that the v2 API is marked as old, and I can’t find equivalent documentation or endpoints for form submissions in **v3**. Does this mean HubSpot is moving away from recommending API-based form submissions? Or have I missed something in the v3 documentation?

If v2 is the only way to handle this, is it still safe to use for new projects, or are there alternatives HubSpot suggests?

Any guidance or recommendations would be greatly appreciated!

---

<div class="post-metadata">

**Author:** ![GRajput](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/grajput/32/102020_2.png) [@GRajput](https://community.hubspot.com/u/GRajput)\
**Post date:** [January 24, 2025, 10:26am UTC](https://community.hubspot.com/t/form-submission-v3/124678/2 "2025-01-24T10:26:38Z")

</div>

Hi @Spinks

here is the curl that is working fine for me on the form submission

```lia-code-sample
curl -X POST https://api.hsforms.com/submissions/v3/integration/submit/<portalId>/<formId> \
-H "Content-Type: application/json" \
-d '{
 "fields": [
 {
 "name": "email",
 "value": "example@example.com"
 },
 {
 "name": "firstname",
 "value": "John"
 },
 {
 "name": "lastname",
 "value": "Doe"
 }
 ],
 "context": {
 "hutk": "user-tracking-token",
 "pageUri": "https://www.example.com/contact",
 "pageName": "Contact Us"
 },
 "legalConsentOptions": {
 "consent": {
 "consentToProcess": true,
 "text": "I agree to allow Example Company to store and process my personal data.",
 "communications": [
 {
 "value": true,
 "subscriptionTypeId": 999,
 "text": "I agree to receive marketing communications."
 }
 ]
 }
 }
}'

```

I hope this will help you out. Please mark it as **Solution Accepted and upvote** to help another Community member.  
Thanks!

---

<div class="post-metadata">

**Author:** ![Nagarjoon](https://avatars.discourse-cdn.com/v4/letter/n/e5b9ba/32.png) [@Nagarjoon](https://community.hubspot.com/u/Nagarjoon)\
**Post date:** [January 24, 2025, 4:45pm UTC](https://community.hubspot.com/t/form-submission-v3/124678/3 "2025-01-24T16:45:36Z")

</div>

HubSpot currently recommends using the **v2 Forms API** for pushing form submissions, as there is no equivalent v3 endpoint specifically for form submissions. While the v2 API is labeled as older, it remains fully supported and safe to use for new projects. However, ensure you monitor for updates to HubSpot’s APIs, as they may introduce newer methods in the future.

If you’re concerned about API longevity or best practices, consider using HubSpot’s tracking code API to capture submissions directly on your website or explore third-party middleware options to manage the integration.

Cloudify can help with [custom integration solutions](https://cloudify.biz/workflow-automation) to seamlessly connect Umbraco forms with HubSpot, ensuring reliability and alignment with your business need.

> **[Hubspot Integration | Cloudify](https://cloudify.biz/hubspot-integration)**
>
> Integrate HubSpot to any apps and get crucial and time-consuming processes and workflows automated with Cloudify.

---

<div class="post-metadata">

**Author:** ![VNovTraceParts](https://avatars.discourse-cdn.com/v4/letter/v/3ab097/32.png) [@VNovTraceParts](https://community.hubspot.com/u/VNovTraceParts)\
**Post date:** [March 3, 2026, 2:55pm UTC](https://community.hubspot.com/t/form-submission-v3/124678/4 "2026-03-03T14:55:32Z")

</div>

I am having similar issues as the original poster, but I cannot find the exact endpoint under v2 Forms documentation ([Update an existing form - HubSpot docs](https://developers.hubspot.com/docs/api-reference/legacy/forms-v2/forms/put-forms-v2-forms-form_guid)) that allows submissions of data to an existing form. The v2 group seems to be related to creation, editing, and deleting the whole form as a structure, not the data that is submitted through it.

Could you point me in the right direction please?

Thanks!

---

<div class="post-metadata">

**Author:** ![Berangere](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/berangere/32/220784_2.png) [@Berangere](https://community.hubspot.com/u/Berangere)\
**Post date:** [March 4, 2026, 11:06am UTC](https://community.hubspot.com/t/form-submission-v3/124678/5 "2026-03-04T11:06:38Z")

</div>

Hi @VNovTraceParts and welcome, it’s a pleasure to have you here!  
Great question, thanks for asking the HubSpot Community!  
To submit data to an existing form, you’ll want to use the Form Submissions API, which is separate from the Forms management API (that one’s just for creating, editing, or deleting forms).  
There are two submission endpoints you can use:

- [Unauthenticated](https://developers.hubspot.com/docs/api-reference/legacy/forms-v3-legacy/post-submissions-v3-integration-submit-portalId-formGuid): POST /submissions/v3/integration/submit/{portalId}/{formGuid}  
- [Authenticated](https://developers.hubspot.com/docs/api-reference/legacy/forms-v3-legacy/post-submissions-v3-integration-secure-submit-portalId-formGuid): POST /submissions/v3/integration/secure/submit/{portalId}/{formGuid}  
Just as a heads up: the management endpoints you were checking out (from Forms v2) are specifically for managing the structure of your forms, but they don’t support submitting data.

If you have any other questions, I’m happy to help! 🧡  
Bérangère  
_This post was created with the assistance of AI tools_

---

<div class="post-metadata">

**Author:** ![VNovTraceParts](https://avatars.discourse-cdn.com/v4/letter/v/3ab097/32.png) [@VNovTraceParts](https://community.hubspot.com/u/VNovTraceParts)\
**Post date:** [March 4, 2026, 11:24am UTC](https://community.hubspot.com/t/form-submission-v3/124678/6 "2026-03-04T11:24:42Z")

</div>

Hi Bérangère, thank you for your prompt reply!

I am already using the authenticated version of the Form submission API, but my concern is that currently, both authenticated and unauthenticated versions of the endpoints are flagged as Legacy. I assume this means that over time they will become deprecated and unsupported, so I was looking for alternatives and/or equivalent API calls that are not Legacy. Is there such an API call? Or should I continue using the abovementioned endpoints for form submission?

Thanks!

---

<div class="post-metadata">

**Author:** ![Berangere](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/berangere/32/220784_2.png) [@Berangere](https://community.hubspot.com/u/Berangere)\
**Post date:** [March 5, 2026, 4:18pm UTC](https://community.hubspot.com/t/form-submission-v3/124678/7 "2026-03-05T16:18:44Z")

</div>

Hey @VNovTraceParts and thanks getting back to us!  
The form submission endpoints you’re using (/submissions/v3/integration/secure/submit/ and /submissions/v3/integration/submit/) are considered legacy, but currently, there isn’t a newer alternative for submitting form data.  
The v3 Forms API focuses on form management, not submissions.

Submission endpoints will be updated in the future. For now, it’s best to continue using the authenticated legacy endpoint ([/submissions/v3/integration/secure/submit/{portalId}/{formGuid}](https://developers.hubspot.com/docs/api-reference/legacy/forms-v3-legacy/post-submissions-v3-integration-secure-submit-portalId-formGuid)) until we release a new version.  
Thanks,  
Bérangère  
_This post was created with the assistance of AI tools_

---

<div class="post-metadata">

**Author:** ![Mike\_Eastwood](https://d10pqhm3lwygmk.cloudfront.net/user_avatar/community.hubspot.com/mike_eastwood/32/70075_2.png) [@Mike\_Eastwood](https://community.hubspot.com/u/Mike_Eastwood)\
**Post date:** [April 9, 2026, 11:49pm UTC](https://community.hubspot.com/t/form-submission-v3/124678/8 "2026-04-09T23:49:00Z")

</div>

Thank you [@BérangèreL](https://community.hubspot.com/t5/user/viewprofilepage/user-id/230185)

Unfortunalely the \* Docs \* Team \* broke another \* \* \* link.  
Here are the current links:

> **[Submit data to a form (unauthenticated) - HubSpot docs](https://developers.hubspot.com/docs/api-reference/legacy/marketing/forms/v3-legacy/submit-data-unauthenticated)**
>
> Send form submission data to a HubSpot form, specified by form ID. This endpoint supports cross-origin (CORS) AJAX requests.

> **[Submit data to a form (supporting authentication) - HubSpot docs](https://developers.hubspot.com/docs/api-reference/legacy/marketing/forms/v3-legacy/submit-data-authenticated)**
>
> Send form submission data to a HubSpot form, specified by form ID. This endpoint requires authentication and has higher rate limits.

That should work until the \* Docs \* Team \* \* break the docs again.

Mike

\*swear words redacted