Skip to content

HubSpot Integration

Learn how to set up OneClick Tracking.

OneClick Tracking is a new feature for Meta Ads advertisers who use HubSpot as their CRM. It provides accurate tracking of qualified leads.

This solution corrects wrong attributions made by Meta, delivering real data based on UTMs and enabling safer scaling decisions.

With OneClick Tracking you see the volume of real conversions per period right in your Ads Manager, making for a quick and clear audit, without the need for complicated dashboards that have to be kept up to date.

Note: OneClick Tracking eliminates the need for extra tracking tools!


Setting up HubSpot to generate a Long-Lived Token

Section titled “Setting up HubSpot to generate a Long-Lived Token”

Before integrating OneClick Tracking with HubSpot, you need to create an integration and generate a long-lived token. Follow the steps below.

  • Accessing HubSpot’s integrations area You need administrator permission on the HubSpot account.
  • Log in to your HubSpot account
  • Go to Settings -> Integrations -> ‘Legacy Apps’

image1

  • Creating the integration On the integration creation screen, fill in the fields as shown below:

    image2

  • Create a private integration

  • Add a name and a description for the integration Example: OneClick Tracking

    image3

  • In the ‘Scopes’ tab, add the read (‘read’) items to give your token API permissions:

image4 image5

  • In the Webhooks tab, add the webhook URL copied in step 6 of the OneClick Tracking setup below:

image6 image7

  • Now create a Subscription for this webhook and add these parameters:

image8

  • Select all events and create the subscription with the button at the top right (‘Create App’):

image9 image10

  • Generating the Long-Lived Token After creating the integration you can access your token in the ‘Auth’ tab:

    image11

  • Click ‘Show token’

  • Copy it and paste it in step 5.1 of the OneClick Tracking setup below:

    image12


  1. Log in to your OneClick Ads account.

  2. Go to the "OneClick Tracking" tab, available in the left sidebar of OneClick Ads.

    The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card

  3. Click "New Integration".

  4. Select the "Lead Generation" product type and click Continue.

  5. Select the "HubSpot" platform and click Continue.

5.1. Enter your long-lived API token and click Connect.

5.2. Now open the funnel and the stage at which the conversion will be fired. If you set the conversion to happen at “segunda-etapa” (second stage), as in the example below, OneClick Tracking will record that conversion in your Ads Manager when a lead is placed in that stage.

image14

  1. Copy the Webhook URL and add it inside HubSpot following the steps in the first part of this document.
  1. Copy the UTM Script generated in OneClick Tracking.

    The UTM parameters step of OneClick Tracking, with the parameter to copy

    7.1. Paste it into the "URL parameters" field in ALL of your ads in Ads Manager, as shown below:

    The URL parameters field of an ad in Meta Ads Manager

  1. Add the UTM Passthrough Script to all your sales pages, so the UTMs are automatically carried into the card of each lead generated. a. You can install it on your website via Google Tag Manager or, preferably, directly in your website's header.
  1. Set the Attribution Mode.

    The Attribution Mode step of OneClick Tracking

  2. Set the Naming Convention that your campaigns, ad sets and ads will receive in your Ads Manager and click next.

The Campaign Naming step of OneClick Tracking Analysis periods and the Naming Convention preview


Wait at least 24 hours for the setup to take effect, and all your campaigns (those that receive conversions) will start recording conversions right inside Ads Manager.

Campaigns with the OneClick Tracking prefix in Ads Manager

  • Only campaigns created after the setup will have access to the “Maximum Period” data. This does not affect OneClick Ads optimization of older campaigns in any way.