--- title: "How to set up a HubSpot integration in Beamer" slug: "how-to-set-up-a-hubspot-integration-in-beamer" updated: 2026-10-26T16:44:03Z published: 2026-10-26T16:44:03Z canonical: "help.userflow.com/how-to-set-up-a-hubspot-integration-in-beamer" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.userflow.com/llms.txt > Use this file to discover all available pages before exploring further. # How to set up a HubSpot integration in Beamer *Available for selected Changelog Scale, Custom & NPS Scale customers.* ### Getting access Our team turns the HubSpot integration on for your account. Open the chat at the bottom-left of your dashboard, type "talk to a person," and send us your Product ID and that you'd like the HubSpot integration enabled. Automated replies can't turn it on, so the request needs to reach our team. If you clicked **Connect** and the chat opened with a message already filled in, send it, then type "talk to a person" in the same chat. Integrating with HubSpot streamlines your marketing efforts by directly connecting your customer feedback and announcements with your CRM. This integration enables you to sync user data, track engagement, and create more personalized marketing campaigns based on user interactions with your Beamer content. ### Step 1: Initialize the connection 1. From the sidebar, select Integrations. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/682486c7c06e1ce20633449e_hubspot-integration-in-beamer-1.jpg) 2. Select **All Integrations** from the menu and click **Connect** next to the HubSpot integration. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/682486d3a0bf47e745ee8eae_hubspot-integration-in-beamer-2.jpg) 3. Enter a descriptive name for the connection and click **Connect** to proceed with the authentication. *You will be directed to HubSpot’s authorization page, where you must grant Beamer permission to access your HubSpot account.* ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/682486e22e3345a993e53bc2_hubspot-integration-in-beamer-3.jpg) 4. Select the HubSpot account you want to connect with Beamer. *You’ll see the account name, website URL, and account ID to help identify the correct account.* ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/682486f1121d28993d6bf902_hubspot-integration-in-beamer-4.jpg) 5. Click **Choose Account**. ### Step 2: Configure workflow settings After successfully connecting your HubSpot account, you’ll be directed to the Workflow tab. Here, you can set up bi-directional data synchronization between the two platforms with two options: - **Option 1:** Sync HubSpot contacts to Beamer users**‍** - **Option 2:** Sync Beamer users to HubSpot contacts #### Option 1: Sync HubSpot contacts to Beamer users This workflow automatically syncs new and existing HubSpot contacts and their property updates to your Beamer user database. To enable this option: 1. Use the toggle switch to activate the workflow. 2. Click on the option to configure its property mappings. 3. Click **Select HubSpot properties to watch for updates** to expand it. 4. Search for HubSpot properties by typing their names in the search field and selecting each one you want to sync. *They’ll appear as tags once selected.* **Important:** We strongly recommend adding the following properties at a minimum: ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/682486ff9b00d8ee578ba063_hubspot-integration-in-beamer-5.jpg) - **Email** (essential for proper identification) - A **unique identifier** (such as Contact ID or Record ID) to ensure consistent syncing. 5. Click **Map Beamer user attributes to HubSpot properties** to expand it. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/68248711a6063e2dc2714bef_hubspot-integration-in-beamer-6.jpg) 6. Select the corresponding HubSpot property from the dropdown for each Beamer user attribute. *The property values from HubSpot will be reflected in Beamer as the respective attributes.* 7. To map an attribute, click the input field and: ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/68248721091c8c464afb242c_hubspot-integration-in-beamer-7.jpg) - Search for the corresponding property using the search box. - Select it from the displayed property options. 8. Once you’ve completed your property mapping, click **Continue** to finalize your mappings. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/6824872d93d684449f78ae3b_hubspot-integration-in-beamer-8.jpg) 9. Click **Save** to save your workflow. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/6824873d5598a2429a3fe153_hubspot-integration-in-beamer-9.jpg) After saving your workflow configuration, the system will begin synchronizing data between platforms. New HubSpot contacts and any updates to mapped properties in existing contacts will automatically populate in your Beamer user database. Please note that our synchronization system checks for updates every 5 minutes, so allow a short time before verifying changes in your Beamer **Users** section. #### Option 2: Sync Beamer users to HubSpot contacts This workflow synchronizes your Beamer users and their updates to HubSpot contacts. To enable this option: 1. Use the toggle switch to activate the workflow. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/6824874df8b6b97044af9c80_hubspot-integration-in-beamer-10.jpg) 2. Click **Map HubSpot properties to Beamer attributes** to expand it. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/6824875da6063e2dc2717fe2_hubspot-integration-in-beamer-11.jpg) 3. Select the corresponding Beamer user attribute from the drop-down for each HubSpot property you want to update. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/6824876a8108a7ed1aedd571_hubspot-integration-in-beamer-12.jpg) 4. To map a property, click the input field and: ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/6824877a1459a58ddec0bd7a_hubspot-integration-in-beamer-13.jpg) - Search for the corresponding Beamer attribute using the search box. - Select it from the displayed attributes. 5. Once you’ve completed your property mapping, click **Continue** to finalize your mappings. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/6824872d93d684449f78ae3b_hubspot-integration-in-beamer-8.jpg) 6. Click **Save** to save your workflow. ![](https://cdn.us.document360.io/9697557a-eb5d-476f-9b09-062b0f7bdcbd/Images/Documentation/6824878f6183bbf2b25499a8_hubspot-integration-in-beamer-14.jpg) This option is perfect for tracking how your users interact with your Beamer content directly in HubSpot, allowing for more targeted marketing campaigns. ### Choosing which properties to watch The properties you pick under **Select HubSpot properties to watch for updates** decide how often the sync runs. Every update to a watched property on a contact triggers a sync for that contact, and that consumes your API allowance. A property that changes on most of your contacts every day will fire a sync for most of your contact base every day. This is the part that catches people out: it doesn't scale with how many of your users are active. It scales with how many contacts the property touches, and how often. Beamer includes a monthly API allowance of 2,000 requests on Starter, 20,000 on Pro, and 100,000 on Scale. To sanity-check a property before you add it, estimate your contact count multiplied by how many times a day the property changes, then by 30. If that number is anywhere near your plan's monthly allowance, it's the wrong property to watch. A field that a nightly job rewrites across your entire contact list will fail this test on almost any list size. Pick properties that change when a person does something: - **Good choices:** last login date, last activity date, lifecycle stage, a plan or subscription field. - **Avoid:** anything written by a nightly batch job, a data-warehouse sync, or a scheduled enrichment tool. These update on nearly every contact regardless of whether the person did anything. - **Keep the list short.** Email and a unique identifier (Contact ID or Record ID) are the minimum. Add other properties only when a Beamer segment or user attribute actually depends on them. **Check your usage early.** Go to **Settings > API** in your Beamer dashboard to see your current month's API usage. Check it a day or two after you set up or change a sync, before the volume builds. For what's included and what overages cost, see [Is there any limit for API requests?](https://help.userflow.com/beamer/docs/en/is-there-any-message-limit-for-single-user-notifications) **You can't filter the sync by property value.** The sync fires whenever a watched property is updated, whatever the new value is. There's no setting to sync only when a property equals a particular value. If you run a separate Beamer account per region or per brand, every matching contact update still syncs to the connected account. ### HubSpot integration best practices - **Consistent Property Mapping**: If you enable both workflows, ensure consistency by mapping the same identifiers in both sync directions. - **Start with Essential Properties**: Begin with mapping critical properties such as email and ID fields before adding more complex properties. - **Frequent Verification**: Periodically check that your data is flowing correctly between platforms.**‍** - **Update Triggers**: Syncing happens when a watched property is updated, not just when it's created — and each sync consumes your API allowance. See **Choosing which properties to watch** above before you finalise your property list.