HubSpot CRM Integration
Automatically create or update HubSpot contacts every time someone fills out your form — no manual data entry needed.
Field Mapping
first_namefirstname(string)last_namelastname(string)emailemail(string)companycompany(string)messagemessage(string)Prerequisites
- A HubSpot account (Free, Starter, Professional, or Enterprise)
- A Private App with the
crm.objects.contacts.writescope enabled
Setup
1
Create a Private App in HubSpot
Go to app.hubspot.com, navigate to Settings > Integrations > Private Apps, and click Create a private app. Under Scopes, enable crm.objects.contacts.write.
2
Copy your access token
After creating the app, HubSpot will generate an access token. Copy it — you'll paste this into Flowqen in the next step. The token looks like:
HubSpot Access Token
pat-na1-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
3
Configure in Flowqen
Go to your form's Settings tab, then Integrations. Scroll down to the HubSpot section and:
- Toggle "Enable HubSpot sync" on
- Paste your Access Token and map form fields to HubSpot properties
- Click Save Settings, then "Send Test" to verify
HubSpot integration settings panel in Flowqen
Payload
POST
https://api.hubapi.com/crm/v3/objects/contactsHubSpot Contacts API
{"properties": {"firstname": "Jane","lastname": "Smith","email": "jane@example.com","company": "Acme Inc","message": "I'd like to learn more about your services.","hs_lead_status": "NEW"}}
Good to know
- HubSpot sync is fire-and-forget — it never delays or blocks the form submission.
- If a contact with the same email already exists, their properties are updated instead of duplicated.
- Your access token is stored securely and never exposed to form submitters.
- You can map any form field to any HubSpot contact property.
- Works with HubSpot Free, Starter, Professional, and Enterprise plans.