POST
/
submissions
/
v3
/
integration
/
submit
/
{portalId}
/
{formGuid}
Submit data to a form (unauthenticated)
curl --request POST \
  --url https://api.hsforms.com/submissions/v3/integration/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 account that the form belongs to.

formGuid
string
required

The unique 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.