With the Zonka Feedback and HubSpot Integration, you can:
Create new or update existing HubSpot Objects (Contacts, Companies, Deals, and Custom Objects) when new Survey Responses are received in Zonka Feedback.
Create timeline activities on existing Contacts, Companies, or Deals directly from survey responses.
Sync your Survey Scores (NPS, CSAT, CES) and full Survey Response data back to existing Contacts, Companies, or both in HubSpot.
Map Survey Attributes, Response Attributes, Hidden Attributes, and Contact Attributes — in addition to survey question answers — to HubSpot properties.
In this section
What do you need for this integration?
Zonka Feedback account – Growth or Enterprise Plan
HubSpot account – Any paid plan
Setting up the HubSpot Integration with Zonka Feedback
Choose a Survey from Survey List View and head to the Integrations Tab from the top navigation.
Click on 'Connect' in HubSpot
Next you will see the HubSpot Integrations Detail Page where you can click to 'Connect to HubSpot' to connect your Zonka Feedback Account.
You’ll be redirected to HubSpot. If you're not logged in, you will have to log in at this step. If you're logged in and you have multiple accounts, you can choose the account you'd like to connect at this step.
Once logged in, you will see an Authorization Screen. Click on 'Connect app' to give permission to Zonka Feedback to access your HubSpot account.
You’ll be directed back to Zonka Feedback. Now you can manage your settings to add new Contacts to HubSpot when new Zonka Feedback Survey Responses are received and to sync Survey Response data and CX scores to existing contacts in HubSpot.
Creating/Updating Records in HubSpot (Mappings)
Once you have connected your HubSpot and Zonka Feedback accounts, you can now set conditions to add new Contacts to HubSpot once Zonka Feedback Survey Responses are received. Here's how.
Go to Integrations within the Survey you'd like to add new Contacts in HubSpot for. (To do this, choose the Survey from the Survey List, navigate to Build from the top navigation and go to Integrations).
Navigate to HubSpot and click on Settings to manage the HubSpot Integration.
Adding a Mapping
Go to Integrations within the Survey (Survey List → Build → Integrations → HubSpot → Settings).
Ensure the Create/Update records to HubSpot toggle is turned on.
Click Add Mapping. A slide-in panel will appear on the right.
Fill in the following: Mapping Name – A friendly name to help you identify this mapping. HubSpot Object – Choose which HubSpot Object to create or update:
Contacts
Companies
Deals (For Deals, you'll also select a Pipeline and Deal Stage.)
Custom Objects (Any custom HubSpot Objects configured in your HubSpot account.)
Select an Action – Choose what should happen when a Survey Response is received (see full details in the next section). Select a Mapping Condition – Choose when this mapping should trigger:
Everytime – Triggers for every new Survey Response.
Only When – Triggers only when specific filter conditions are met. You can add multiple filters and choose whether All or Any conditions need to be satisfied.
Required Fields Notice – A blue info box will highlight the required fields for the selected HubSpot Object. Ensure these are mapped for a successful sync:
Contacts → Email is required
Companies → Company Name or Company Domain Name is required (at least one must be mapped)
Deals → Deal Name is required
Custom Objects → Required fields will depend on your Custom Object configuration in HubSpot.
Field Mapping – Map your Zonka Feedback fields to the corresponding HubSpot Object properties. This includes Survey Questions, Survey Attributes, Response Attributes, Hidden Attributes, and Contact Attributes. Fields you don't want to map can be left as No Mapping.
Click Save to activate the mapping.
You can create multiple mappings across different HubSpot Objects.
Select an Action
When adding or editing a mapping, the Select an Action dropdown determines how Zonka Feedback interacts with HubSpot records. The available actions are:
Create a new one – Creates a new HubSpot record every time a Survey Response is received. Skips if a matching record already exists.
Update fields – Updates the fields on a matching existing record. Never creates a new record.
Create or update – Updates the matching record if one exists, or creates a new one if none is found. (Default and recommended for most use cases.)
Create an activity on timeline – Creates a Zonka Feedback timeline activity on an existing HubSpot record. Available for Contacts, Companies, and Deals only. See the section below for details.
Supported HubSpot Objects and their Match Keys
When a Survey Response is received, Zonka Feedback identifies existing HubSpot records using the following match keys:
HubSpot Object | Match Key Used to Identify Existing Record |
Contacts | Email Address |
Companies | Company Name or Company Domain Name |
Deals | Deal Name |
Custom Objects | Depends on your Custom Object configuration in HubSpot |
If a matching record is found, the mapped fields will be updated (or a timeline activity created, depending on the Action selected). If no match is found, a new record will be created — unless the Update fields action is selected.
Creating a Timeline Activity on an Existing Record
The Create an activity on timeline action lets you log survey responses as a timeline event on an existing HubSpot Contact, Company, or Deal — without creating or updating any record fields.
This is available for Contacts, Companies, and Deals only (not Custom Objects).
To use this, Zonka Feedback needs to identify which HubSpot record to attach the activity to. You do this by passing a HubSpot record ID as a hidden parameter in your survey.
How it works:
When setting up your mapping, select Create an activity on timeline as the Action.
A Matching Criteria section will appear, showing the parameter name to use:
For Contacts → pass
hb_contact_idFor Companies → pass
hb_company_idFor Deals → pass
hb_deal_id
Pass the relevant ID as a key-value pair in your survey distribution:
For Web Surveys → append as a URL parameter, e.g.
?hb_company_id=12345For Email or SMS Surveys → pass it as a hidden parameter in the survey link
When a response is submitted, Zonka Feedback will find the matching HubSpot record using this ID and create a timeline activity with the full survey response.
Note: The Select a Mapping Condition (Everytime or Only When) still applies when using the timeline activity action.
Mapping Attributes (Survey, Response, Hidden, Contact)
In addition to mapping survey question answers, you can also map the following attribute types to HubSpot properties:
Survey Attributes
Date Submitted
Survey Name
Survey Duration
Response Attributes
Response ID
Hidden Attributes
Any hidden fields you pass into the survey via URL parameters or embedded code (e.g.,
hb_company_id, custom identifiers).
Contact Attributes
Any Contact Attribute fields defined in Zonka Feedback (e.g., Full Name, Email, Mobile Number, External ID, and any custom properties).
To map these, click the dropdown next to any HubSpot property field in the mapping panel. You will see a searchable list grouped by attribute type. Select the attribute you want to map and click Save.
Tip: Use + Add Attribute at the bottom of the field mapping panel to add additional attribute rows beyond the default fields shown.
Editing your Mappings
From the HubSpot Integration Detail Page, click View All Mappings.
Your existing mappings will appear in the slide-in panel on the right.
Click Edit next to the mapping you want to modify.
In the Mapping Editor, you can:
Change the Mapping Name
Change the HubSpot Object, Pipeline, or Deal Stage (for Deals)
Change the Syncing Conditions
Update the Field Mapping
Click Update to save your changes.
Deactivating or Deleting your Mappings
From the HubSpot Integration Detail Page, click View All Mappings.
Hover over a mapping and click the three dots (⋯) menu.
Choose Deactivate or Delete:
Deactivate – Temporarily pauses the mapping. No new records will be created or updated until you reactivate it.
Delete – Permanently removes the mapping. This cannot be undone, but you can recreate it at any time.
Note: Editing, Deactivating, or Deleting a mapping does not affect any previously synced data.
Syncing Survey Responses and Scores back to HubSpot
When you collect feedback from your existing customers or leads, you can sync Survey Responses and CX Scores (NPS, CSAT, CES) back to their corresponding records in HubSpot.
Go to Integrations within the Survey (Survey List → Build → Integrations → HubSpot → Settings).
Turn on the Sync back responses in HubSpot toggle.
Under Objects to be Synced, select which HubSpot Objects should receive the synced data. You can select:
Contact
Company
(Or both)
Choose what to sync:
Sync scores to properties – Syncs CX scores to the following dedicated properties on the HubSpot Contact and/or Company record:
Zonka Feedback NPS
Zonka Feedback CSAT
Zonka Feedback CES
Sync responses to timeline – Adds the full survey response as a Timeline Activity on the HubSpot Object.
Click Save.
Important points:
Contacts are matched by Email Address – if the email in the Zonka Feedback Survey Response or Contact Attribute matches a HubSpot Contact's email, scores and responses will be synced to that Contact.
Companies are matched by Company Name.
Both Contacts and Companies can be synced simultaneously if both are selected under Objects to be Synced.
Viewing Zonka Feedback Activity on the HubSpot Timeline
When Sync responses to timeline is enabled, every Survey Response will appear as a Zonka Feedback activity on the HubSpot record's activity timeline.
To view these activities in HubSpot:
Open the HubSpot Contact or Company record.
Click on the Activities tab.
Click Filter activity at the top of the activity feed.
In the filter panel, locate the INTEGRATIONS section and check Zonka Feedback.
The timeline will now display all Zonka Feedback Survey Responses submitted for that record, including:
Survey question responses
CX Scores (NPS, CSAT, CES)
Respondent details (Email, Name, etc.)
A View full Zonka Feedback Survey Response link
Field Mapping Reference
When setting up your mappings, the tables below show how Zonka Feedback fields correspond to HubSpot property types across Contacts, Companies, and Deals.
Contact Information Fields → HubSpot Contact Properties
Zonka Feedback Field | HubSpot Contact Property |
Full Name | Full Name / Single-line Text |
First Name | First Name / Single-line Text |
Last Name | Last Name / Single-line Text |
Email (required — used as match key) | |
Mobile Number | Phone Number / Mobile |
Gender | Gender (Custom) |
Country | Country/Region / Dropdown Select |
Time Zone | Time Zone / Dropdown Select |
Language | Preferred Language / Dropdown Select |
External ID | Contact ID / External ID / Single-line Text |
Anniversary | Date |
Birthday | Date |
Survey & Response Attributes → HubSpot Property Types
Zonka Attribute | Attribute Type | HubSpot Property Type |
Date Submitted | Survey Attribute | Date Picker |
Survey Name | Survey Attribute | Single-line Text |
Survey Duration | Survey Attribute | Number |
Response ID | Response Attribute | Single-line Text |
Hidden Fields (e.g. hb_contact_id) | Hidden Attribute | Single-line Text |
Question Types → HubSpot Property Types
Choices
Zonka Question Type | HubSpot Property Type |
Button Choice (single) | Radio Select |
Button Choice (multiple selection ON) | Multiple Checkboxes |
Radio Buttons | Radio Select |
Dropdown | Dropdown Select |
Checkbox | Multiple Checkboxes |
Picture Choice (single) | Radio Select |
Picture Choice (multiple selection ON) | Multiple Checkboxes |
Text & Input
Zonka Question Type | HubSpot Property Type |
Text Box | Single-line Text |
Comment Box | Multi-line Text |
Date | Date Picker |
Rating & Scales
Zonka Question Type | HubSpot Property Type |
NPS | Number (0–10) |
CES | Single-line Text |
CSAT | Number |
Rating | Number |
0–10 Scale | Number |
Ranking | Multi-line Text / Single-line Text |
Tip: If you don't see Zonka Feedback activities, make sure the Sync responses to timeline option is enabled and saved in your HubSpot Integration settings in Zonka Feedback.