Skip to content

HubSpot integration

Create a HubSpot contact for each submission, or update the existing one with the same email. This is a Pro and Agency feature. Free accounts can use it on their first 50 submissions.

Formkove connects with a HubSpot service key.

  1. In HubSpot, open Development → Keys → Service Keys and create a key
  2. Add two scopes: crm.objects.contacts.write and crm.schemas.contacts.read
  3. Copy the key

If you already have a private app with those scopes, its access token works too.

  1. Open app.formkove.com and select your form
  2. Go to Integrations and click Connect HubSpot
  3. Paste the key and click Continue
  4. Map the properties (see below), optionally add a label and routing rules, then click Connect HubSpot

The key is stored encrypted and is never shown again.

Email is required. Map it to the form field that holds the email, usually email. Then pick what goes in each contact property, like First name, Phone or Message. Use Find a field to search the list. Each property takes a form field, a Formkove value (Submitted at, Submission ID, Form name, Sentiment, Tags, Spam score, File links) or a fixed value.

Properties HubSpot fills itself (created date, calculated and read-only properties) aren’t writable, and most internal hs_ properties aren’t listed. For dropdown and checkbox properties, send HubSpot’s internal option value, not the label. Several checkbox values can be comma-separated.

  • Formkove creates the contact, or updates the contact with the same email
  • The email is saved in lowercase
  • A submission without a valid email address isn’t sent. The delivery history says so
  • Spam isn’t sent to HubSpot

HubSpot may also create a company from the email’s domain and link the contact to it. This comes from HubSpot’s own company settings.

Send test checks that the key can reach your contacts. It doesn’t add a contact.

Problem Fix
Contacts don’t show up Check the connection is enabled and has no routing rule that filters it out, then look at Integrations → Delivery history
“HubSpot rejected the token” The key was deleted or rotated. Delete the connection and connect again with the new key
“The token can’t write contacts” Add the crm.objects.contacts.write scope to the key
“HubSpot refused a property value” A value doesn’t fit its property, often a dropdown value that isn’t an option. Check the mapping

Deleting the connection keeps your contacts in HubSpot. To revoke Formkove’s access, delete the key in HubSpot.