Validate and Troubleshoot Your HubSpot Integration
Ensure your HubSpot integration is working correctly in both directions.
Verify Your Workflows Are Active
Before troubleshooting data issues, confirm your Zapier workflows are active and running:
- Log in to your Zapier account.
- Navigate to "Zaps" to see all your workflows.
- Check that all your HubSpot workflows show as "Active".
- Review the "Zap Runs" for each workflow to see recent executions by entering the workflow and clicking the option on the left-hand side.
- If a workflow is paused or off, publish it to turn it back on.
Test With Sample Data
To verify your workflows are configured correctly:
- In Zapier, open one of your HubSpot workflows.
- Click "Test" on each step to run it with sample data.
- Verify that each step completes successfully without errors.
- Check that the final action step (Create Contact or Update Lead) shows success.
- Look in the destination platform to confirm the record was created.
Troubleshoot WhatConverts to HubSpot Workflows
Issue: Contacts Not Being Created in HubSpot
Possible causes and solutions:
- Workflow is paused or turned off: Check your Zapier dashboard and turn the workflow back on
- API credentials expired: Reconnect both your WhatConverts and HubSpot accounts in Zapier
- Required fields missing: Verify that the WhatConverts lead has all required information (email is required for HubSpot contacts)
- Trigger not firing: Check WhatConverts to confirm new leads are actually being tracked
Issue: Lead ID Not Storing in HubSpot
Possible causes and solutions:
- Custom property not created: Verify you created the custom property in HubSpot for storing Lead IDs in Contact Properties
- Property not mapped: Check your workflow to ensure the Lead ID from WhatConverts is mapped to the correct custom property in HubSpot
- Property type mismatch: Ensure the custom property in HubSpot is set to accept text or numbers
- Using the wrong action: Make sure you're using "Create or Update Contact" which allows custom property mapping
Issue: Duplicate Contacts Being Created
Possible causes and solutions:
- Email not being used: HubSpot uses email as the primary identifier - ensure you're mapping the email field from WhatConverts
- Different email formats: If email formatting differs, HubSpot may not recognize them as duplicates
- Workflow triggering multiple times: Check your Zapier task history to see if the workflow is running multiple times for the same lead
Troubleshoot HubSpot to WhatConverts Workflows
Issue: Leads Not Being Updated in WhatConverts
Possible causes and solutions:
- Lead ID not stored: If the HubSpot contact doesn't have a WhatConverts Lead ID in the custom property, the update can't find the correct lead
- Lead ID property not mapped: Verify your workflow is pulling the Lead ID from the correct custom property in HubSpot
- Wrong lead ID value: Check that the stored Lead ID actually corresponds to an existing lead in WhatConverts
- Find Lead step failing: If using the Find Lead approach, ensure phone or email exactly matches the lead in WhatConverts
- Deal not associated with contact: Ensure the deal in HubSpot is associated with a contact that has the Lead ID stored
Issue: Quote/Sales Values Not Updating Correctly
Possible causes and solutions:
- Wrong field mapping: Verify you're mapping the correct HubSpot deal amount to Quote Value and Sales Value in WhatConverts
- Data type mismatch: Ensure the values being sent are numbers, not text
- Empty values: Check that the HubSpot deal actually has an amount value
- Field mapping to the wrong WhatConverts field: Confirm you're updating the correct fields (Quote Value vs Sales Value)
- Deal stage not triggering: Ensure your trigger is configured to fire on the correct deal stage changes
Issue: Workflow Updates Wrong Lead
Possible causes and solutions:
- No Lead ID stored: Without the stored Lead ID, the Find Lead step may match the wrong lead if multiple leads share similar contact information
- Search criteria too broad: If searching by partial phone or email, you may match incorrect leads -- use exact match criteria
- Multiple leads with same contact info: Some businesses may have legitimate duplicate contact information -- this is why Lead ID storage is critical
Issue: Trigger Firing Too Often
Possible causes and solutions:
- Trigger set to any deal update: If your trigger is "Updated Deal" without filters, it will fire on any field change -- add trigger filters to only fire on specific deal stage changes
- Bulk updates in HubSpot: If you're doing bulk updates in HubSpot, this may trigger many workflow runs -- consider temporarily pausing the workflow
- Integration loops: Ensure you don't have workflows that create circular updates between the platforms
Validate Data Accuracy
For WhatConverts to HubSpot workflows
- Create a test lead in WhatConverts with known details.
- Wait for the workflow to trigger (usually within 1-15 minutes).
- Check your HubSpot account for the new contact.
- Verify all mapped properties are populated correctly.
- Confirm the Lead ID is stored in the custom property.
For HubSpot to WhatConverts workflows
- Update a deal in HubSpot or change its stage.
- Ensure the associated contact has a WhatConverts Lead ID stored in the custom property.
- Wait for the workflow to trigger.
- Check WhatConverts to confirm the lead was updated with the correct deal values.
- Verify the update was applied to the correct lead (check using the Lead ID).
Check API Connection Status
If you suspect authentication issues:
- In Zapier, open your HubSpot workflow.
- Click on any HubSpot step.
- Click "Change" next to the connected account.
- Try reconnecting with your HubSpot credentials.
- Repeat for the WhatConverts connection if needed.
- Test the connection by running a sample through the workflow.
Related Topics
Get a FREE presentation of WhatConverts
One of our marketing experts will give you a full presentation of how WhatConverts can help you grow your business.
Schedule a Demo