How do I connect HelloForms to HubSpot?

Create a private app with crm.objects.contacts.write and copy the token. Paste it below. We map email, first/last name, phone and company when those answers exist. You can do the whole thing from the form's Integrations tab — no code and no developer account required.

What do I need before I start?

You need hubspot private app token. Everything else is configured in HelloForms.

What does HubSpot receive for each submission?

A HubSpot contact create-or-update using email as the identifier. You choose which questions are included, so fields you would rather keep private never leave HelloForms.

Is the HubSpot integration available on the free plan?

Yes. Delivery destinations are part of the product rather than a paid add-on, so you can connect and test one on a free form before upgrading.

What happens if a delivery to HubSpot fails?

Transient failures are retried automatically with exponential backoff, and every attempt is written to the delivery log with the status code and the response body the provider returned. Repeated hard failures disable the destination instead of retrying forever, and you can retry a specific submission from the response.

Where are my credentials stored?

Tokens and secrets are stored server-side, are never rendered in your published form, and are shown masked in the dashboard. Delivery happens from the server, so nothing is exposed to respondents.

Can I reuse the same HubSpot connection on other forms?

Yes. Save it as an account-level connection once and pick it from the credentials selector when you add the destination to another form — you never re-enter the token.

CRM & data integration

Send form responses to HubSpot

Create a HubSpot private app with the crm.objects.contacts.write scope and paste the token into your form. Email, first and last name, phone and company are mapped from the matching answers, creating or updating the contact.

Build a form free Browse templates

What the HubSpot integration does

Creates or updates by email, so repeat submissions do not duplicate the contact.
Private app token stays server-side and is never exposed in the published form.
Pick which email question identifies the contact when a form has several.

What it looks like

A HubSpot contact create-or-update using email as the identifier.

HelloForms — response

Removals enquiry · #4821

Full name: Priya Raman
Email: priya@northgate.co
Service needed: Office move
Budget: £2,000 – £5,000

HubSpot — record created

Priya Raman

Created from Removals enquiry · #4821

Full name: Priya Raman
Email: priya@northgate.co
Service needed: Office move
Budget: £2,000 – £5,000

Demo data: a HelloForms response on the left, and how it arrives in HubSpot on the right.

How to connect HubSpot to your form

1
Create a private app with crm.objects.contacts.write and copy the token.
2
Paste it below. We map email, first/last name, phone and company when those answers exist.

What you’ll need

HubSpot private app token.
Email question label (optional) — Defaults to the first email answer.

Credentials are stored server-side and never rendered in your published form. Every delivery attempt is logged, transient failures are retried with backoff, and repeated failures disable the destination instead of retrying forever.

Configuration template and sample payload

Download a filled-in checklist of every value the HubSpot destination asks for, plus an example of exactly what HubSpot receives for one submission — useful for planning a mapping or handing the setup to a developer.

Every field the "Add integration" dialog asks for, with placeholders to fill in. Keep it as documentation of your HubSpot mapping — do not commit a completed copy to a public repository.

{
  "$schema": "https://helloforms.net/integrations/config-template.schema.json",
  "helloforms": {
    "destination": "hubspot",
    "label": "HubSpot",
    "docs": "https://helloforms.net/integrations/hubspot"
  },
  "enabled": true,
  "events": [
    "submission.created"
  ],
  "credential": {
    "label": "HubSpot private app token",
    "value": "<paste-your-token-here>"
  },
  "config": {
    "emailField": "Email"
  },
  "includedQuestions": [
    "Full name",
    "Email",
    "How can we help?"
  ],
  "notes": [
    "Never commit a filled-in copy of this file to a public repository.",
    "Values are entered in HelloForms → your form → Integrations; this file is a checklist and a record of your mapping."
  ]
}

HubSpot integration FAQs

Who uses it

Marketing teams feeding gated content or demo-request forms into HubSpot.
Sales teams that work leads in HubSpot sequences.
Event registration forms that need contacts in the CRM before follow-up.

Salesforce
Creates a Lead, Contact or custom record from every submission.
Salesforce integration
Mailchimp
Subscribes the respondent to a Mailchimp audience.
Mailchimp integration
Zapier
Sends flat, Zap-friendly JSON to a Catch Hook trigger.
Zapier integration

Build a form that feeds HubSpot today

Every destination is included on every plan — no per-integration add-ons.

Start building See all integrations