Documentation / Product / Integrations / HubSpot

HubSpot: Export Audiences

Keep your HubSpot email lists up to date with your Lytics audiences. Update and add properties from Lytics to HubSpot.

Integration Details

  • Implementation Type: Server-side.
  • Implementation Technique: REST API. Audience triggers.
  • Frequency: Real-time.
  • Resulting data: Contacts will be created or updated when they enter or exit the audience. User properties may be created if they are selected for export but do not exist in HubSpot.

This integration utilizes the Hubspot APIs to send user data. Once the export is started the job will:

  1. Check if the Lytics property group exists, and create the Lytics property group if it does not exist.
  2. Check if the selected properties exists in HubSpot. For the properties that do not exist, they will be created under the Lytics property group.
  3. Check if the selected list exists in HubSpot, if not create it. For dynamic lists, the filter will be ly_audiences CONTAINS the exported audience's slug.
  4. Create Batches of up to 500 users.
  5. Create/update the batch of contacts in HubSpot.
  6. If the list is static, add the batch of contacts to the List.
  7. As users enter the audience steps 3-5 will be repeated for them. The batch will fill for 5 min or until it reaches 500 users, whichever happens first.
  8. If users exit the audience they will also be added to a batch and updated in HubSpot like users entering the audience (steps 3-4). If the list is static, they will be removed from the list after being updated.

Fields

By default, Lytics exports the following fields to HubSpot:

Lytics User FieldDescriptionHubSpot FieldType
emailEmail AddressEmailstring
-comma separated list of audience slugsly_audiencesstring

Configuration

Follow these steps to set up and configure an export job for HubSpot in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select HubSpot from the list of providers.
  2. Select the Export Audiences job type from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Select the audience to export.
  7. Complete the configuration steps for your job.
  8. (optional) From the List input, select the list to export to. If left blank or Create new list is selected, a new list will be created using the audience's slug as the name. The list's name can be changed while the export job is running.
  9. (optional) Select the Dynamic checkbox, to set if the list is/should be Dynamic (active). Note: if you have selected an existing dynamic list, exported users will only enter the list if they match the list's filter, Lytics will not force users to match the list's filter.
  10. (optional) From the Email Field input, select the Lytics field that contains an email. Either Email or Vid field must be set.
  11. (optional) From the Vid Field input, select the lytics field that contains a vid. Either Email or Vid field must be set.
  12. (optional) From the Map Fields input, select the Lytics field on the left, and its HubSpot destination on the right.
  13. (optional) From the Fields to Create input, select a list of user fields to create in HubSpot. All properties will be created under the Lytics property group.
  14. (optional) Select the Include Lytics Audience Membership checkbox, to include the user's audience membership as a property called ly_audiences. All properties will be created under the Lytics property group. Dynamic lists will do this regardless of this field.
  15. Click Start Export.