Skip to main content

CRM & automation

HubSpot in Core Forms

Create or update HubSpot contacts with standard and custom property mapping.

Bundled with Core Forms, the WordPress forms plugin with every premium feature in the box. No add-on tax.

Bundled, no add-on tax Unlimited sites Use code BLACKFRIDAY for 40% off either plan. Ends December 2 (IST).

This HubSpot WordPress form integration creates or updates a HubSpot CRM contact by email on every successful submission. Map email, name, company, and any custom contact property you've defined. You need a HubSpot Private App token with the crm.objects.contacts.write scope. Leads land as real contacts, not HubSpot form submissions.

Send any Core Form submission straight into HubSpot CRM. Email, first name, last name and company map to standard contact properties, and any other field (phone, job title, a custom property) maps with one line per property.

No HubSpot Forms iframe, no third-party add-on — the lead lands as a real HubSpot contact you can sequence and report on.

HubSpot at a glance

Requires
HubSpot Private App token (pat-...)
Scope
crm.objects.contacts.write
Creates
Contact, created or updated by email
Standard fields
Email, first name, last name, company
Custom properties
form_field=hubspot_property, one per line
Timeout
15 seconds

Full reference: HubSpot action reference

What you get

How HubSpot works in Core Forms

Native contact creation

Creates real HubSpot contacts (not just form submissions) so they’re available to every workflow.

Property mapping

Map to standard contact properties or any custom property you’ve defined.

Update by email

An existing contact with the same email is updated instead of duplicated.

One line per property

Custom mappings use form_field=hubspot_property, for example role=jobtitle. The property must already exist in HubSpot.

Use cases

What people build with HubSpot and Core Forms

Demo requests with job titles

Map company to company and job_title to jobtitle so sales sees who's asking before the first call.

Keep existing contacts current

When a known contact submits again, HubSpot updates the same record with the new phone or company instead of creating another.

Only qualified leads

Add a condition so the HubSpot action runs only when inquiry type is sales, and support questions stay out of the CRM.

Event registrations

Map registration answers to custom contact properties you created for the event, ready for HubSpot lists and reports.

Set it up

Connect HubSpot in 3 minutes

  1. 1

    Create a HubSpot private app

    In HubSpot, Settings → Integrations → Private Apps. Grant CRM scopes and copy the access token.

  2. 2

    Paste the token in Core Forms

    Form → Actions → HubSpot, paste the token, save.

  3. 3

    Map properties

    Pick the email, name and company fields, then add one form_field=hubspot_property line per extra property.

Want the long version? Read the step-by-step guide with screenshots of every setting.

Every setting, filter, and error message is documented in the HubSpot action reference.

Inside Core Forms

The action in WP-Admin

The Add to HubSpot action with the private app token, the email, name and company fields selected and a custom property mapped
Three field dropdowns and a property map. The contact is created or updated by email.
Good to know

Requirements and limits

  • Custom properties must exist in HubSpot first (Settings > Properties), and the internal name must match exactly: lowercase, no spaces.
  • If the email field is empty or invalid, the action skips silently, so make the email field required.
  • The Name field is split on the first space into firstname and lastname.
  • The action creates or updates contacts only; it doesn't create deals or tickets.
FAQ

HubSpot integration questions

Which HubSpot permission does the token need?
The Private App needs the crm.objects.contacts.write scope. Create it in HubSpot under Settings > Integrations > Private Apps and copy the token that starts with pat-.
Will HubSpot get duplicate contacts?
No. Core Forms uses HubSpot's create-or-update endpoint keyed on email. If the contact exists, it's updated with the new values; if not, a new one is created.
How do I map custom HubSpot properties?
Add one line per mapping in the format form_field=hubspot_property, such as job_title=jobtitle. The right side is HubSpot's internal property name, and the property must already exist. Examples are in the HubSpot action docs.
Why didn't a submission create a HubSpot contact?
The usual causes are an empty or invalid email (the action skips silently), a custom property that doesn't exist in HubSpot, or a token missing the contacts write scope. Check the action log on the submission for the exact message.
Does this embed HubSpot's own form?
No. Your form is a Core Forms form on your page, and the lead is sent to HubSpot through its API as a contact. There's no HubSpot iframe or embed script.

Bundled with every Core Forms license.

HubSpot and every Core Forms-built integration on this site are included with your license. Use code BLACKFRIDAY for 40% off either plan. Ends December 2 (IST).

Black Friday Sale

40% off Core Forms

Forms, polls, surveys, payments, and licensing — every feature, unlimited sites, one plugin.

Copy your code

Those are the after-discount prices. Paste BLACKFRIDAY at checkout to apply it. BLACKFRIDAY40 works too.

Ends December 2 (IST)