curl --request POST \
--url https://api.hsforms.com/submissions/v3/integration/secure/submit/{portalId}/{formGuid} \
--header 'Content-Type: application/json' \
--data '
{
"fields": [
{
"objectTypeId": "<string>",
"name": "<string>",
"value": "<string>"
}
],
"submittedAt": "<string>",
"context": {
"hutk": "<string>",
"ipAddress": "<string>",
"pageName": "<string>",
"pageUri": "<string>",
"pageId": "<string>",
"sfdcCampaignId": "<string>",
"goToWebinarWebinarKey": "<string>"
},
"legalConsentOptions": {
"consent": {
"consentToProcess": true,
"text": "<string>",
"communications": [
{
"value": true,
"subscriptionTypeId": 123,
"text": "<string>"
}
]
},
"legitimateInterest": {
"value": true,
"subscriptionTypeId": 123,
"legalBasis": "CUSTOMER",
"text": "<string>"
}
},
"skipValidation": true
}
'{
"redirectUri": "<string>",
"inlineMessage": "<string>"
}Send form submission data to a HubSpot form, specified by form ID. This endpoint requires authentication and has higher rate limits.
curl --request POST \
--url https://api.hsforms.com/submissions/v3/integration/secure/submit/{portalId}/{formGuid} \
--header 'Content-Type: application/json' \
--data '
{
"fields": [
{
"objectTypeId": "<string>",
"name": "<string>",
"value": "<string>"
}
],
"submittedAt": "<string>",
"context": {
"hutk": "<string>",
"ipAddress": "<string>",
"pageName": "<string>",
"pageUri": "<string>",
"pageId": "<string>",
"sfdcCampaignId": "<string>",
"goToWebinarWebinarKey": "<string>"
},
"legalConsentOptions": {
"consent": {
"consentToProcess": true,
"text": "<string>",
"communications": [
{
"value": true,
"subscriptionTypeId": 123,
"text": "<string>"
}
]
},
"legitimateInterest": {
"value": true,
"subscriptionTypeId": 123,
"legalBasis": "CUSTOMER",
"text": "<string>"
}
},
"skipValidation": true
}
'{
"redirectUri": "<string>",
"inlineMessage": "<string>"
}Scope requirements
The HubSpot portal the form belongs to.
The ID of the form you're sending data to.
A list of form field names and the values for those fields, up to 1000 fields can be included.
1000Show child attributes
A millisecond timestamp representing the time of the form submission. This can be used to backdate the submission, but using a time more than one month old will result in an error.
Show child attributes
Show child attributes
Whether or not to skip validation based on the form settings. Defaults to false. Note: This parameter is deprecated.
Form submission successful
Was this page helpful?