HubSpot Lookup variable

The HubSpot Lookup variable by Stape lets you pull contact data from HubSpot directly within your Google Tag Manager server container. It uses the HubSpot CRM API to find an existing contact and make selected CRM information available to your server-side tracking tags and workflows.

You can identify a contact by email, Contact ID, or a custom identifier, then choose which HubSpot properties should be returned. The variable also supports response caching through server-side GTM's templateDataStorage, which helps avoid unnecessary API requests when the same contact is looked up repeatedly.

Benefits of the HubSpot Lookup variable

• Connect sGTM with HubSpot CRM: query your HubSpot contact database from the server container and retrieve current contact properties.
• Enrich server-side events: add CRM information such as firstname, lastname, email, phone, or city to the data available during server-side processing.
• Reduce repeated API calls: cache lookup responses in templateDataStorage and define how long cached data should remain available.
• Choose how contacts are identified: use an email address or Contact ID, or define another unique identifier that matches your data.
• Retrieve only the data you need: request selected HubSpot properties or process the entire contact record.

Useful links

1. HubSpot Lookup variable in GTM Template Gallery
2. How to set up the HubSpot Lookup variable