September 23, 2021
HubSpot integration
This article explains how to integrate HubSpot with Wooxy to enable contact synchronization and send Wooxy events to HubSpot via Webhooks.
Things to know before starting
- The integration enables bidirectional synchronization: contacts are imported from HubSpot to Wooxy, while events are reported back to HubSpot via Webhooks.
- Data synchronization is performed exclusively between the HubSpot account and the Default Contact List.
- Contacts are identified and matched solely by phone number or email address, as userId is not supported for this integration.
- All associated variables and attribute values are updated automatically without manual intervention.
Step-by-step Instructions
Navigate to the “Apps & Add-ons” page.
Press the “Hubspot” button.
Click on the “Add integration” button.
Select the HubSpot account for integration and click the “Choose Account” button.
Specify the domain in Wooxy and press the “Create integration” button.
Configure variable mapping to synchronize contact data from HubSpot to Wooxy.
Set up the Webhook by selecting the Wooxy events to report to HubSpot.
-
List of transferable variables
- email - Contact’s email address.
- phoneNumber - Contact’s primary phone number.
- active - The status of the contact in the Contact List.
- contactLanguage - Preferred language for communications; can be updated via import, form, or integration.
- firstName - Contact’s first name.
- lastName - Contact’s last name.
- jobtitle - Contact’s job title.
- hs_lead_status - The contact’s sales, prospecting, or outreach status.
- city - Contact’s city of residence.
- state - The contact’s state of residence.
- zip - The contact’s zip code or postal code.
- address - Contact’s street address, including apartment or unit number.
- country - The contact’s country of residence.
- lifecyclestage - The contact's qualification level regarding sales readiness.
- company - The name of the contact’s company (independent of associated company properties).
- website - The contact’s company website URL.
- salutation - The title used to address the contact.
- industry - The specific industry the contact operates in.
- date_of_birth - Contact's date of birth.
- days_to_close - Number of days elapsed between account creation and closing as a customer.
- engagements_last_meeting_booked - The date of the most recent meeting scheduled through the meetings tool.
- first_deal_created_date - The date when the first deal was created for this contact.
- gender - Contact's gender.
- hubspot_owner_id - The assigned owner of the contact record.
- ip_city - The city identified via the contact's IP address.
- job_function - The specific job function or role of the contact.
- linkedinbio - Information from the contact's LinkedIn biography.
- marital_status - Contact's marital status.
- notes_last_contacted - The timestamp of the last logged interaction (call, chat, email, meeting, or message).
- num_conversion_events - Total number of forms submitted by the contact.
- num_notes - Total count of interactions (calls, messages, notes, tasks) logged on the contact record.
- Wooxy1 - Wooxy20 - Custom variables (1 through 20) available for transferring specialized data from HubSpot to the Wooxy Default Contact List.
- hs_ip_timezone - The timezone identified via the contact's IP address.
- hs_content_membership_status - Current status of the contact's content membership.
- hs_language - The preferred language for communication.
- hs_avatar_filemanager_key - The CDN path for the contact’s custom avatar image.
- hs_calculated_mobile_number - Mobile number formatted in international standard.
- hs_calculated_phone_number - Phone number formatted in international standard.
- hs_calculated_phone_number_area_code - Area code extracted from the calculated phone number.
- hs_calculated_phone_number_country_code - Country code extracted from the calculated phone number.
- hs_calculated_phone_number_region_code - ISO2 country code derived from the phone number.
- hs_country_region_code - Two-letter country code for the contact.
- hs_email_bad_address - Boolean indicator if the associated email address is invalid.
- hs_email_bounce - Total number of marketing email bounces recorded for the current address.
- hs_email_customer_quarantined_reason - Technical reason for the email address being placed in quarantine.
- hs_email_hard_bounce_reason - Specific issue that caused a permanent (hard) bounce.
- hs_email_hard_bounce_reason_enum - Categorized reason for the hard bounce.
- hs_email_is_ineligible - Indicates if the contact is globally restricted from receiving emails.
- hs_email_optout - Indicates if the contact has opted out of all email communications.
- hs_email_quarantined - Indicates if the email is blocked for anti-abuse reasons.
- hs_email_quarantined_reason - Automated system reason for email quarantine.
- hs_enriched_email_bounce_detected - Flag populated when HubSpot identifies the email as potentially undeliverable.
- hs_first_order_closed_date - The date when the contact's first order was officially closed.
- hs_first_outreach_date - The date of the first recorded communication from a sales representative.
- hs_first_subscription_create_date - The creation date of the contact's first subscription.
- hs_full_name_or_email - The contact's full name (formatted) or email address as a fallback.
- hs_persona - The assigned marketing persona for the contact.
- hs_pipeline - The current sales pipeline associated with the contact.
- hs_timezone - The contact’s specific time zone.
- hs_twitterid - The contact’s Twitter (X) handle/ID.
- hs_whatsapp_phone_number - The phone number linked to the contact's WhatsApp account.
