POST
/
submissions
/
v3
/
integration
/
secure
/
submit
/
{portalId}
/
{formGuid}
Submit data to a form (supporting authentication)
curl --request POST \
  --url https://api.hsforms.com/submissions/v3/integration/secure/submit/{portalId}/{formGuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "submittedAt": "<string>",
  "fields": [
    {
      "objectTypeId": "<string>",
      "name": "<string>",
      "value": "<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>"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

portalId
string
required

The HubSpot portal the form belongs to.

formGuid
string
required

The ID of the form you're sending data to.

Body

application/json

Response

200
application/json

Form submission successful

The response is of type object.