HubSpot Integration

Connect HubSpot to Popl Teams for syncing Popl leads as HubSpot contacts with auto or manual syncs

In this document, we will provide a step by step walkthrough of how to setup our direct integration with HubSpot! This integration will allow your team to instantly sync leads from Popl as contacts in your team's HubSpot account.

This integration will automatically connect to the fields below, with no additional configurations needed:

  • First name

  • Last name

  • Email

  • Job Title

  • Company name

  • Phone number

  • Website

  • Location

  • Contact Owner (will be the member that connected with that lead via Popl)

  • Any custom fields you set up on the "Configuration" tab (optional)

Connecting your HubSpot Account

1. First, from the home page of Popl Teams, click into the "Integrations" tab. Then find the section for HubSpot and click "Connect".

  • If you've already connected HubSpot at any point before, the button will be "Configure" instead of "Connect". Go ahead and click configure instead if that is the case.

2. Next, you will see a HubSpot popup as shown below. Click on "Connect" in the top right of the popup.

3. A window will then pop up asking you first to log into your HubSpot account. The account you use to login here should be a HubSpot admin to allow our integration to work correctly. Once you have logged in, HubSpot will have you choose which account you'd like to connect to Popl.

4. After choosing your account, the HubSpot window will disappear and you will see that the button in the top right of the popup now shows "Connected". Great job! Now you can toggle on one of our 2 available workflows.

Syncing Leads to HubSpot

1. Now that your HubSpot is connected, there are 2 options for workflows that you can turn on:

  • AUTO SYNC - Convert Popl Leads into HubSpot Contacts The Auto Sync workflow will automatically sync leads from Popl to HubSpot at the very moment that any member of your team captures a new lead via Popl. This workflow completely removes any sort of manual data entry and lead selection, saving your team time and creating incredible efficiency.

  • Convert Popl Leads into HubSpot Contacts The normal sync workflow is for teams that want an admin or member(s) to choose which leads that they would like to sync over to HubSpot before they are synced. This workflow has more control than the auto sync as admins/members can decide exactly which leads should be synced and which leads shouldn't be.

2. Once you have chosen a workflow to switch on (both can be turned on if needed), next up is customizing the integration connection. Both workflows have the same customization options and here is more details on each option:

Contact Lead Status

This field allows for setting certain lead statuses to contacts that sync over from Popl. For example, if you would like all contacts synced from Popl to be set to "New", you would choose the "New" option here. All available statuses provided in the dropdown are dynamic to your HubSpot account.

HubSpot Contact Owners

The contact owner field allows for setting specific owners to contacts that are synced over from Popl. For example, if your company would like all contacts synced from Popl to be owned by John Smith, you would choose John Smith from the dropdown here. If left blank, the integration will automatically set the contact owner to the same user that collected the contact via Popl. This matching from Popl user to HubSpot user is done by email, so make sure that the email that is associated with each Popl user is the same email that is used for each user's HubSpot account.

Custom Mappings

This section allows you to set up an unlimited number of custom mappings between fields in Popl and fields in HubSpot. For the "Object Name" field, make sure to select "Contact", then create your mappings. Note: The Object Name must be set to "Contact" in this field otherwise, custom mappings will not work.

The values for the "Application Field" are dynamically pulled from any lead capture fields or template lead capture fields that you have added in Popl Teams and the values for "hubspot Field" are dynamically pulled from the contact properties in your HubSpot.

For example, let's say that you have a custom lead capture form on Popl Teams that gets a value called "State" from your leads/prospects. If you'd like to map the "State" values from Popl to a field called "State/Province" on HubSpot, you would select "state" for the "Application Field" and then select "State/Province" for the "hubspot Field".

If you'd like to add another custom mapping, just click "+ Add Mapping".

Where to Map Tags from Popl

This field is for setting where you'd like tags that are added on Popl to sync to in HubSpot. This field provides a dynamic dropdown of available contact properties based on your HubSpot account.

If multiple tags are added to a lead that is synced, the integration will sync all tags over to this chosen field. This mapping option is also completely optional.

Custom Contact Properties

This field is for setting custom values for HubSpot contacts. For example, if you would like all contacts from Popl to have your HubSpot property "Lead Source" set to "Popl", you would put this JSON string value:


You can set multiple custom values by using the JSON format:

{"field 1 internal name":"value 1","field 2 internal name":"value 2",etc}

If for some reason the mapping above is not working correctly, check your HubSpot account for the "internal name" of the HubSpot field. Sometimes the internal name of this field is different than it's normal name.

Once your customization is complete, simply click X in the top right of the popup to return to Popl Teams. All customization is auto saved, so no need to click any sort of save button.

Congrats! 🎉

Once your desired workflow(s) are enabled, you are all set! Now you or your team can export leads at any time from the Popl Dashboard or the Popl mobile app to your HubSpot account.

Check out Popl Teams to instantly start syncing leads from Popl Teams to your HubSpot!

If any issues or questions, please contact us at, we are available nearly 24/7 and will get back to you within 6-8 hours or less.

With 🤍 from Popl.

Last updated