HubSpot Integration

Update: As you may know, to make your portal more secure, HubSpot is switching off all access via the API Key on November 30, 2022. By the end of November, any connections you have built using the API key must be switched over to Private Apps.

Setup


Step 1: Obtain your HubSpot APP Key

  1. Register or Login to your HubSpot account.
  2. Obtain your HubSpot APP Key by Navigating to HubSpot Settings -> Integrations -> APP Key (Example Pictured);
    mceclip1.png
  3. While in this same page of HubSpot Settings, In the Address URL Bar of your browser, the "Portal Id" value we require will be present (Example Pictured);
    mceclip2.png
  4. Please send an email to support@enquiresolutions.com with the above information.
  5. If it doesn't exist already, Setup the "community" Property for Contacts/Contact Information inside HubSpot (Reference - https://knowledge.hubspot.com/crm-setup/manage-your-properties);
    mceclip1.png
    mceclip2.png
    mceclip3.png
  6. On the last step of creation, please choose 'Dropdown Select' as the Field Type and enter each of your company's locations/communities that are wanting the integration. (NameUnique values can be found by clicking on the Community Details Pages in Enquire and clicking the 'Summary' tab)

Setup HubSpot Webform/Workflow/Webhook


Note: You only need to follow these setup steps if you would like to use a HubSpot Form to push individuals into Enquire CRM.

Step 1: Create your HubSpot Webform

  1. Log in to your HubSpot account.
  2. Along the top menu, click Marketing, then click Forms.
    mceclip1.png
  3. Create a new Form (Contact Us / Blank Template) with the following Form Fields / Contact Properties (may need to be created if not already-created/selectable):

    *Community (community),
    *First Name (firstname),
    *Last Name (lastname),
    Care Level (care_level),
    Address (address),
    City (city),
    State (state),
    Zip Code (zip),
    Email (email),
    Phone (phone),
    Message (message),
    Market Source (market_source),
    Individual Type (individualtype),
    Activity Type (activity_type),
    Activity Description (activity_description),
    Activity Result (activity_result)

* Indicates required
(Other properties are optional. Almost all Properties can be marked hidden and/or have a default value set if needed)

Alert: The Activity Type and Activity Result must match the types and results in Enquire, otherwise the activity will not be created.
(Activity Types can be found here - https://account.enquiresolutions.com/type/?typeId=7 and
Activity Results can be found here - https://account.enquiresolutions.com/type/?typeId=38)

hubspot_activities.png

hubspot_form.pnghidden_field_hubspot.png

💡 Your community's NameUnique is a unique identifier specifically for your community. This ensures that individuals are sent to the correct community. If you aren't sure where to find your community's NameUnique, follow our help desk article on Locating your Community UniqueName

 

Step 2: Obtain your Enquire API Subscription Keys

  1. Register or Log in at https://developer.enquiresolutions.com

    Note: If you need to register for Enquire's API, make sure you register for API 3.0.

  2. Once you have successfully registered, click your name in the upper right, click Profile.
  3. To the right of your Primary key for your 3.0 subscription, click the Show button to view your APP Key.
    show_api_key_enquire.png

Step 3: Create your HubSpot Workflow/Webhook

Requirements:

  1. Click Automation, then Workflows.
    mceclip3.png
  2. Click Create workflow in the upper right.
  3. Choose the Enrollment Trigger for the workflow (Any Form Submission/Specific Form Submission)
  4. Click the small plus sign (+) and in the Select an action search field, search for Trigger a webhook.
    trigger_webhook.png
  5. Create the Webhook with the POST Method using the URL of: 
    https://api2.enquiresolutions.com/v3/hubspotwebhook?subscription-key=12345a567cb84ff45&PortalId=xxx
    (where the subscription-key=Your Enquire Primary API 3.0 Subscription Key; and PortalId=Your Enquire Portal Id)
  6. Click Save.

Plugins

All integrations require an Enquire team member to complete setup of the Plugins.  Please reach out to your Enquire Account Manager or Support Team at support@enquiresolutions.com for further assistance.

Usage


Sync lists to HubSpot

  1. Create a list using Enquire CRM's Advanced Search. Make sure to include the filter of Addresses --> Has Email --> Yes. An email address is required for individuals to sync to HubSpot.
  2. Once your list is created, click People on the left menu, click Lists.
  3. In the Sync? column for the lists you would like to sync with HubSpot, click the OFF switch to the ON position.
    sync_lists_hubspot.png

 

View HubSpot Display

  1. On a profile, click the Plug-ins menu item along the top of the profile.
    plug-ins_profile.png
  2. To the right of the HubSpot option, click View Activity.
    view_activity_hubspot.png
  3. Expand each section to view details about the individual.mceclip0.png

HubSpot FAQs


The lists I chose to sync aren't displaying in HubSpot
  1. Make sure that you have followed the setup steps above and that the list you are syncing includes the filter of Addresses --> Has Email --> Yes. Each individual in a list must have an email address for a list to successfully sync to HubSpot.

    Note: If any individual in your list doesn't have an email address or a valid email address, the list in its entirety will not sync.

  2. Make sure that all parts of every individual's email is spelled correctly. For example: If an individual's email is entered as john.doe@gmail.come, the entire list with this individual will fail to sync because it should be @gmail.com.
An activity wasn't created based on what I had setup. Why?

Ensure the activity Type and Result match exactly what you have in Enquire including capitalization and spacing.

Was this article helpful?
0 out of 0 found this helpful