Vixiees integrates with HubSpot to sync contacts, activities, and keep both systems updated in real time.
Connect HubSpot
Requirements
- HubSpot account with administrator permissions
- Administrator permissions in Vixiees
Steps to connect
- Go to Settings > Integrations > HubSpot
- Click Connect with HubSpot
- Sign in to your HubSpot account
- Authorize the requested permissions
- Wait for the initial sync to complete
Synced data
When connecting, Vixiees syncs:
- Existing contacts
- Contact properties
- Deal pipelines
- Deal properties
Contact synchronization
Automatically synced fields
| Vixiees field | HubSpot field |
|---|---|
| First name | firstname |
| Last name | lastname |
| Phone | phone |
| Company | company |
Additional fields
- Lead status (hs_lead_status)
- Lifecycle stage (lifecyclestage)
- Owner (hubspot_owner_id)
Sync direction
- Contact created in Vixiees → Created in HubSpot
- Contact created in HubSpot → Created in Vixiees (via webhook)
- Changes in either system → Reflected in the other
Activity synchronization
Calls
Each call made in Vixiees is logged in HubSpot with:
| Field | Description |
|---|---|
| Timestamp | Date and time of the call |
| Duration | Call length |
| Numbers | Origin and destination |
| Recording | Recording URL (if available) |
| Direction | Inbound or outbound |
| Status | Completed, busy, no answer, etc. |
Emails
Emails sent from Vixiees are logged with:
- Subject
- Content (HTML and text)
- Direction (inbound or outbound)
- Timestamp
Notes
Notes created in Vixiees are synced with:
- Note content
- User who created it
- Timestamp
Activity sync is unidirectional (Vixiees → HubSpot).
Custom field mapping
You can map custom Vixiees fields to HubSpot properties:
- Go to Settings > Integrations > HubSpot
- In the Field mapping section, configure the equivalences
- Select the Vixiees field and the corresponding HubSpot property
- Save changes
Skills synchronization
You can configure a HubSpot field to sync contact skills. Skills are saved separated by semicolons.
Webhooks and events
HubSpot notifies Vixiees when changes occur:
Contact events
- Contact created
- Property modified
- Contact deleted
- Contacts merged
Deal events
- Deal created
- Property modified
- Stage changed
Security
Webhooks are validated with HMAC-SHA256 signature to ensure they come from HubSpot.
Common errors and solutions
"Token expired"
Cause: The access token has expired.
Solution: The system automatically renews the token. If it persists, reconnect the integration.
"Contact not found"
Cause: The contact was deleted in HubSpot.
Solution: The system retries up to 3 times and then discards the notification.
"Request limit exceeded"
Cause: HubSpot's rate limit was exceeded.
Solution: The system automatically waits and retries.
"Validation error"
Cause: A field has an invalid value for HubSpot.
Solution: Check the field mapping and allowed values.
Duplicate contacts
Cause: Contacts already arrive duplicated from HubSpot. The platform syncs what HubSpot sends without modifying it.
Solution: Duplicate management must be done in HubSpot.
Vixiees custom properties
When connecting, Vixiees automatically creates in HubSpot:
| Property | Description |
|---|---|
| vixiees_url | Contact URL in Vixiees |
| vixiees_last_update | Last update from Vixiees |
Conclusion
The HubSpot integration allows you to:
- Keep contacts synced in both systems
- Log all Vixiees activities in HubSpot
- Use custom fields with flexible mapping
- Receive real-time updates via webhooks
Relevant scenarios
- Sales teams with HubSpot CRM: All commercial activity is logged automatically
- Marketing and sales integrated: Marketing leads arrive in Vixiees via HubSpot
- Performance analytics: HubSpot can use activity data for reports
Was this article helpful?