HubSpot Deal Properties: How to Map Quiz Results with Custom Field Mapping

Your lead qualification quiz collects rich data, use case, budget range, team size, urgency, feature priorities. But if that data stays inside your quiz tool while your sales team lives in HubSpot, the quiz is just a fancy form that creates extra work. Someone has to manually check quiz results, then update HubSpot records by hand.

The fix is a direct integration: quiz submission triggers a HubSpot contact update, creates or updates a deal record, maps every answer to HubSpot deal properties and contact properties, and triggers the right sales workflow. Your AE opens the individual deal records and sees a complete qualification profile, no tab-switching, no copy-pasting, no context lost in translation.

Here's how to set up the full flow between involve.me and HubSpot.

What the HubSpot Integration Does

When a prospect completes your involve.me quiz, the integration automatically:

• Creates or updates a HubSpot contact with the prospect's email, name, and company

• Maps quiz answers to custom contact properties (use case, team size, budget, tools used)

• Maps calculated scores to contact properties (qualification score, plan recommendation)

• Creates a HubSpot deal associated with the contact, pre-populated with deal name, deal amount, stage, and pipeline

• Triggers HubSpot workflows based on the deal data (AE assignment, email sequences, Slack notifications)

The result: zero manual data entry between quiz completion and the first sales touchpoint.

Prerequisites Before Setting Up HubSpot Deal Properties

In HubSpot:

• A HubSpot account (Marketing Hub or Sales Hub Professional or higher for custom properties and workflows)

• Custom contact properties created for each quiz data point you want to capture

• Custom deal properties if you want quiz data on the deal record

• A deal pipeline configured with stages matching your sales process, including a closed won deal stage and a closed lost deal stage so quiz-sourced deals can be accurately filed at the end of the cycle

In involve.me:

• A completed quiz with scoring configured

• An involve.me paid plan (Starter or above) (the HubSpot integration is available on all paid plans)

• Your HubSpot account connected via involve.me's native integration

Step 1: Create Your HubSpot Deal Properties

Before mapping, create the properties in HubSpot that will receive quiz data. HubSpot comes with a set of default deal properties out of the box, things like deal amount, close date, and pipeline, but you will need to create custom ones to capture quiz-specific data points.

Contact Properties

Navigate to Settings → Properties → Contact Properties → Create Property.
Field type for scores: For any score property, select Number type, not Single-line Text. If you use Text, a score of 32 can render as 32.000 in HubSpot. Number type prevents this.

HubSpot Deal Properties

Navigate to Settings → Properties → Deal Properties → Create Property:

Step 2: Configure the involve.me Integration

Connect HubSpot

1. Navigate to the Connect tab in the top navbar of your involve.me account.

2. Find HubSpot's card and click Connect.

3. Alternatively, open the dropdown menu on your funnel card and select Connect, this links the integration directly to that specific funnel immediately.

4. After authorising, select the HubSpot portal you want to connect to (if you have multiple).

Set Up Field Mapping on Your Quiz

1. After connecting HubSpot to your funnel (via the funnel card dropdown → Connect), go to the funnel's integration settings. 2. Click the "Manage Custom Fields" button that appears there. 3. This is where you map involve.me fields to your HubSpot contact properties and custom deal properties.

Map Quiz Fields to Contact Properties

For each quiz question and calculated value, create a mapping inside Manage Custom Fields:

Direct answer mappings:

• "What's your primary goal?" → quiz_primary_use_case

• "How many team members?" → quiz_team_size

• "Monthly budget?" → quiz_budget_range

• "Current tools?" → quiz_current_tools

• "Timeline?" → quiz_buying_timeline

• "Integration needs?" → quiz_integration_needs

Calculated value mappings:

• Quiz total score → quiz_qualification_score

• Outcome/recommended plan → quiz_recommended_plan

To personalise the outcome page for each respondent, drag the Personalized AI Text element from the element panel into your outcome page (it is not a toggle or setting, it is a content element). Write a prompt using answer piping to reference the respondent's quiz answers.

• Submission timestamp → quiz_completed_date

Contact identity mappings

• Email field → email (primary identifier)

Business plan and above: Enable OTP Verification on the email field inside the Contact Form element settings to send a one-time code and verify each address before submission reaches HubSpot.

Pro plan: Block disposable/temporary email addresses via Settings → Email validation options.

All paid plans: Basic email format validation runs automatically on all submissions.

• Name field → firstname / lastname

• Company field → company

Pass Attribution Data with Hidden Fields

Use hidden fields in the quiz embed URL to pass UTM parameters, referral source, and landing page URL into the submission data, so every HubSpot contact and deal record includes the campaign and channel that drove the quiz completion:

https://your-quiz.involve.me/qualification?utm_source=google&utm_medium=cpc&utm_campaign=demo_quiz&landing_page=pricing

Map these to HubSpot contact properties like utm_source, utm_medium, utm_campaign, and quiz_source_url for full attribution visibility in your deal records.

Configure Deal Creation and Property Mapping

In the involve.me HubSpot integration settings:

1. Enable "Create Deal on Submission"

2. Set the deal name format, for example, "[Company] — Quiz Lead [Date]" — so deals are easy to identify in your pipeline view

3. Set the deal pipeline (e.g., "Sales Pipeline")

4. Set the initial deal status / stage based on quiz score:

   • Score 70+ → "Qualified" stage

   • Score 40–69 → "Discovery" stage

   • Score under 40 → Don't create a deal (nurture instead)

5. Map deal amount from the quiz's plan recommendation:

   • Starter recommendation → $348 (annual price)

   • Pro recommendation → $948

   • Business recommendation → $1,548

6. Assign the deal owner automatically based on score band or territory, for example, route all high-score deals directly to a named AE. The owner assigned date will be recorded automatically in HubSpot when the owner field is populated.

7. The create date field is set automatically by HubSpot when the deal record is created — you do not need to map this manually.

8. Map your custom HubSpot deal properties:

   • deal_qualification_score ← Quiz total score

   • deal_recommended_plan ← Outcome recommendation

   • deal_use_case ← Primary use case answer

   • deal_team_size ← Team size answer

   • deal_qualification_method ← "Lead Qualification Quiz"

Step 3: Build HubSpot Workflows from Quiz Data

Workflow 1: Lead Routing by Qualification Score

Trigger: Contact property quiz_qualification_score is known

Branch 1 — High Score (70+)

• Set lifecycle stage to SQL

• Set lead status to "Attempting to Contact"

• Create task: "Follow up with high-score quiz lead within 4 hours"

• Send internal notification (email or Slack)

• Enroll in "Hot Lead" email sequence

Branch 2 — Medium Score (40–69)

• Set lifecycle stage to MQL

• Set lead status to "Open"

• Enroll in "Demo Invitation" email sequence

• Create task: "Review quiz lead and schedule demo"

Branch 3 — Low Score (under 40)

• Set lifecycle stage to Lead

• Enroll in "Educational Nurture" email sequence

• Do not create deal (unless manually moved by sales)

When a deal reaches the end of its cycle, update the stage accordingly: deals marked as closed won move to the winning stage, while those lost are recorded in the closed lost stage for pipeline reporting and loss-reason analysis.

Workflow 2: Plan-Specific Follow-Up

Trigger: Contact property quiz_recommended_plan is known

Branch: Starter

• Send email: "Your recommended plan: Starter — here's what's included"

• Delay 3 days → Send: "Quick-start guide for [their use case]"

• Delay 7 days → Send: "How [similar company] uses Starter for [their use case]"

Branch: Pro

• Send email: "Your recommended plan: Pro, built for teams like yours"

• Delay 2 days → Send: "Pro feature spotlight: [feature relevant to their use case]"

• Delay 5 days → Send: "Book a 15-minute demo to see Pro in action"

Branch: Business

• Immediate AE email: personalized introduction

• Delay 1 day → Send case study relevant to their industry/use case

• Delay 3 days → AE follow-up if no response

For SaaS products with subscription billing, also consider mapping revenue fields. HubSpot's recurring revenue tracking uses several dedicated fields: monthly recurring revenue, annual recurring revenue, total contract value, recurring revenue date (the date MRR or ARR begins), and recurring revenue inactive reason (populated when a subscription is cancelled or paused, and the field when recurring revenue is set to inactive). Set these on the deal record when a deal closes so your revenue reporting stays accurate from day one.

Workflow 3: Integration-Specific Nurture

Trigger: Contact property quiz_integration_needs contains values

• HubSpot integration selected → Send: "How to connect [Product] to HubSpot in 5 minutes"

• Salesforce integration selected → Send: "Your Salesforce integration guide"

• Multiple integrations selected → Send: "Setting up your connected tech stack"

Alternatively, use involve.me's built-in Automations feature to trigger conditional email sequences directly from quiz outcomes, without needing HubSpot workflows for the initial follow-up. Use involve.me Automations for immediate post-quiz responses, and HubSpot workflows for sustained multi-step nurture sequences.

Step 4: Verify the Data Flow

Testing Checklist

Before going live, run through each of these steps:

• Complete the quiz with a test email address

• Check HubSpot contact record: verify all custom contact properties populated correctly

• Check deal properties: confirm the deal was created with the correct pipeline, stage, amount, and mapped HubSpot deal properties

• Check contact–deal association: the contact should be linked to the new deal

• Check workflow enrollment: verify the contact enrolled in the correct workflow based on score

• Check email delivery: confirm follow-up sequences triggered correctly

• Test edge cases: submit with minimum answers, maximum score, and boundary scores (39, 40, 69, 70)

Common Issues

"Properties not mapping" Ensure the involve.me field names exactly match the HubSpot internal property names (lowercase with underscores). Also confirm the property's Group is a native HubSpot group, custom-created groups will not appear in involve.me's Manage Custom Fields dropdown. HubSpot internal names are case-sensitive.

"Deal not creating" Check that the deal pipeline exists in HubSpot and the stage names match exactly. Verify the score threshold logic in your conditional mapping.

"Duplicate contacts" involve.me uses email as the primary identifier. If a contact already exists with that email, it updates the existing deals and contact record rather than creating a duplicate. Verify that "update existing contacts" is enabled in the integration settings.

"Workflow not triggering" HubSpot workflows trigger on property changes, not on values already present. Re-submitting the quiz with the same email and same score will not re-trigger a workflow. Use a fresh test email address for every test run.

Optimization: A/B Testing Your Qualification Quiz

You can A/B test quiz variations to improve both completion rates and lead quality:

Test 1: Question Order

• Version A: Company info → Budget → Use case → Timeline

• Version B: Use case → Budget → Company info → Timeline

• Measure: Completion rate, average time-to-completion, average score

Test 2: Question Wording

• Version A: "Which of these integrations do you use?" (multi-select)

• Version B: "What's your primary integration need?" (single-select)

• Measure: Answer clarity, downstream workflow accuracy, AE feedback on data quality

Test 3: Outcome Page Messaging

• Version A: Generic plan recommendation

• Version B: Personalized AI Text element (unique narrative per respondent)

• Measure: CTA click-through rate, downstream conversion rate. Use your deal probability data in HubSpot to compare which version produces deals that close at a higher rate, not just which generates more submissions.

  In involve.me:

1. Duplicate your original funnel from the dashboard, the duplicate becomes your variation (Version B). 2. Edit the variation: change the question order, wording, or outcome page content. 3. Publish both funnels. 4. In the dashboard, click the "A/B Tests" tab in the top navigation. 5. Click "+ Create new A/B test", give it a descriptive name, and add both funnels. 6. Share the A/B test URL (not the individual funnel URLs), this is what splits traffic between the two versions. 7. After 2–4 weeks, review Visits, Starts, Submissions, and Completion Rate for each variant in the A/B test dashboard. 8. Manually select the better-performing version as your winner.

Troubleshooting HubSpot Deal Properties and Field Mapping

Pitfall 1: Over-Qualification Leading to High Drop-Off

Problem: Your 15-question quiz has only a 40% completion rate.

Root cause: Too many required fields, too much friction.

Fix:

• Remove questions that don't drive routing decisions

• Make secondary questions optional or conditional

• Test the quiz yourself on mobile, drop-off is frequently a mobile UX issue, not a question issue

• Use involve.me's analytics to identify which page has the highest abandonment rate, then simplify that page

• Move optional fields (e.g., budget) to the end of the quiz

Pitfall 2: Scoring Doesn't Align with Actual Deal Quality

Problem: Quiz marks leads as "highly qualified" (score 80+) but they rarely close.

Root cause: Scoring weights don't reflect real buying signals, often over-weighting company size rather than intent. When a deal moves through your pipeline slowly despite a high quiz score, that is a signal your scoring model needs recalibration.

Fix:

• Audit your last 20 closed deals and compare their quiz answers

• Increase weight on timeline and urgency questions if those correlate with closes

• Re-weight your formula based on actual closed deal patterns

• Run an A/B test comparing old vs. new scoring logic and measure deal velocity

Pitfall 3: HubSpot Deal Properties Not Receiving Data

Problem: You mapped "Budget Range" to a HubSpot deal property but it shows blank in HubSpot.

Causes:

• Property doesn't exist in HubSpot

• Internal name mismatch (e.g., mapped to budget_range but HubSpot property is named annual_budget)

• Property type mismatch (e.g., dropdown mapped to a text field)

• Property was assigned to a custom-created HubSpot group, involve.me cannot write to properties grouped under custom groups; only native HubSpot groups are supported in the mapping dropdown

Fix:

• Go to Settings → Properties in HubSpot, verify the property exists, and note its exact internal name

• In involve.me's Manage Custom Fields settings, confirm the mapping uses the exact internal name

• If the property group is custom-created, move the property to a native HubSpot group and re-map it in involve.me

• Test with a fresh submission and check the HubSpot contact record

Pitfall 4: Workflows Don't Trigger As Expected

Problem: High-score leads aren't getting the AE follow-up email.

Causes:

• Trigger condition value mismatch (conditions are case-sensitive)

• Contact already enrolled, HubSpot won't re-trigger an active workflow enrollment

• Enrollment filters excluding the contact (e.g., "Lifecycle stage is Customer" blocks new-lead flows)

Fix:

• Verify the trigger condition value exactly matches the data being sent from involve.me

• Test with a fresh email address every time

• Check workflow enrollment filters aren't excluding your test contact

Pitfall 5: Data Overload — Too Many Properties

Problem: You've created 30+ custom properties in HubSpot and the deal record view is cluttered.

Fix:

• Group properties into logical property groups in HubSpot ("Quiz Qualification", "Implementation Details", "Technical Stack")

• Configure the deal record sidebar to only display properties that inform routing decisions (qualification score, recommended plan, timeline)

• Archive unused properties

• Use HubSpot calculated properties to combine related fields into a single summary value

• Add a short deal description field to each deal at creation, auto-populated from quiz outcome data, so your team has a plain-language summary without having to read through every individual property

Final Checklist: Before You Launch

Pre-launch (24 hours before go-live):

• Quiz completion rate in testing is 70%+ on both mobile and desktop

• All custom HubSpot deal properties and contact properties created and configured

• Property Groups confirmed as native HubSpot groups (not custom-created)

• Field mapping verified, test submission visible with correct values in HubSpot contact record

• HubSpot deal properties populated correctly on test deal record

• Deal created in correct pipeline with correct stage and amount

• Deal name, owner, and create date fields all populating as expected on the test deal

• HubSpot workflows tested, test contact enrolled in correct workflow per score band

• Email sequences tested and arriving in inbox (not spam)

• Duplicate prevention tested, same email submitted twice updates contact, does not create duplicate

• Mobile UX tested on an actual smartphone

• Analytics dashboard accessible in both involve.me and HubSpot

• Legal review completed, privacy policy linked, consent checkboxes in place

Post-launch (First week):

• Submissions arriving at expected daily volume

• Spot-check 5 submissions in HubSpot for data accuracy across all mapped properties

• Completion rate holding at 60%+

• High-score leads receiving timely follow-ups

• Sales team feedback gathered on data quality and usefulness

Get Started

involve.me's native HubSpot integration handles contact creation, custom field mapping to HubSpot deal properties, deal creation, and workflow triggering, everything you need to connect your quiz directly to your sales pipeline. Once your deal properties are mapped and your workflows are live, every quiz submission becomes a fully populated deal record your sales team can act on immediately, no manual entry, no data lost in handoff.

Connect HubSpot to involve.me