hyper ai / docs / integrations / HubSpot
Integration available

HubSpot Integration

Hyper AI integrates with HubSpot to automatically sync demo session data to your CRM. When a prospect completes a demo with your AI agent, their contact information is pushed directly to HubSpot — and you can map qualification answers to any HubSpot contact property you choose.

OAuth 2.0 CRM sync Field mapping Auto-create contacts
HubSpot
01 — Permissions

Required HubSpot permissions

This integration requests the following HubSpot OAuth scopes. You will be prompted to authorize these when connecting your account.

crm.objects.contacts.read
read
Read access to existing contact records to match prospects by email address before creating new records.
crm.objects.contacts.write
write
Write access to create and update contact records with demo session data and qualification answers.
crm.objects.deals.read
read
Read-only access to the deals associated with contacts who took a Hyper AI demo, to show their stage, amount and close date on the lead in Hyper AI. Hyper AI never creates, edits or deletes deals.
oauth
auth
Secure authorization to connect your HubSpot account. No passwords are stored — access tokens are managed automatically.
02 — How it works

What happens after a demo

Once connected, the integration runs automatically with no manual steps required. Here's the full data flow:

1
Connect via OAuth

Connect your HubSpot account to Hyper AI through the Integrations page using secure OAuth authorization. No API keys or tokens to manage manually.

2
Contact is created or updated

When a prospect completes a demo, Hyper AI automatically creates or updates a contact in HubSpot with the lead's firstname, lastname, email, company, phone, and job_title. Records are matched by email address, so an existing contact is updated instead of duplicated. Leads from Hyper AI webinars and WhatsApp conversations are synced the same way (WhatsApp leads are matched by phone when they have no email).

3
Qualification answers are mapped to properties

For each qualification question in your AI agent, you can map the answer to any HubSpot contact property using the property picker — so your CRM is populated exactly the way your team needs it.

4
UTM parameters are synced

If UTM parameters were captured during the session (utm_source, utm_campaign, etc.), they are included in the sync so you can track which campaigns drive the most engaged demo prospects.

5
A demo note lands on the contact timeline

Each demo adds a note to the contact with the lead score, the duration, a summary, the qualification answers, suggested next steps and a link to the recording, audio and transcript. Your sales team sees the full context before the first call, with no manual handoff.

6
See which demos turn into deals

On each lead in Hyper AI, you see the deals associated with its HubSpot contact: stage, amount, close date and whether it was won or lost. This is read-only; Hyper AI never changes your deals.

03 — Field Mapping

Map qualification answers to HubSpot properties

After connecting your HubSpot account, go to each qualification question in your AI agent settings. You will see a HubSpot property picker that lets you select which HubSpot contact property should receive that answer.

This allows you to route qualification data — such as company size, use case, or budget — directly into the right fields in your CRM without any manual work.

Hyper AI field Contact property
name firstname / lastname
email email
company company
phone phone
job_title jobtitle
qualification_answer any contact property
04 — Setup & Configuration

Getting connected

You need an active Hyper AI account and Super Admin or Admin access to your HubSpot portal to install this integration.

After installing the integration, go to the Hyper AI dashboard and navigate to Integrations. Click Connect next to HubSpot and authorize access to your account. Once connected, all future demo sessions will automatically sync to HubSpot.

Contacts are matched by email address, and new records are created automatically when no match is found. You can disconnect the integration at any time from the Hyper AI Integrations page or from your HubSpot account settings under Settings → Integrations → Connected apps.

05 — Troubleshooting

Frequently asked questions

Make sure the demo session captured a valid email address. Hyper AI uses email as the primary key to match or create contact records. If the prospect didn't provide an email during the session, no record will be synced.
Check that you have selected a HubSpot property for each question in the qualification question settings. Questions without a mapped property are not included in the sync.
Hyper AI shows the deals associated with the HubSpot contact the demo was synced to, so the deal has to be linked to that contact in HubSpot. Connections made before November 2026 do not include the deals permission: go to Integrations, disconnect HubSpot and click Connect again.
Go to Integrations in the Hyper AI dashboard and click Disconnect next to HubSpot. You can also remove the app directly from your HubSpot account under Settings → Integrations → Connected apps.
Reach us at dev@gethyper.ai or book a call with the team at cal.eu/hyper/30min. We typically respond within a few hours.