ClickPatrol home

ClickPatrol setup for HubSpot

Use this page when you install the ClickPatrol app in a HubSpot account. After a paid-ad visit, the existing tag can mark the new contact Safe or Suspicious. Organic mail and social visits stay blank. There is no extra score and no Fake label in HubSpot.

What you need

  1. A ClickPatrol account. Plans are on clickpatrol.com/pricing.
  2. The ClickPatrol tag on the site that holds the HubSpot form. Use Google Tag Manager, the WordPress plugin, or another official loader. Use one path only.
  3. Permission to install apps in the HubSpot account.

1. Connect HubSpot

  1. Open the ClickPatrol listing in the HubSpot Marketplace, or go to clickpatrol.com/api/hubspot/.
  2. Click Connect HubSpot.
  3. Approve the scopes you see. This version asks for contact read, contact write, and permission to create the ClickPatrol traffic property. Nothing else.
  4. After the redirect, the app creates that property on the account if it is missing.

2. Put the field on each form

  1. In HubSpot, open Marketing, then Forms.
  2. Edit a form that should carry the label.
  3. Add the property ClickPatrol traffic (clickpatrol_traffic).
  4. Hide the field in the editor, or hide it with CSS if the new form editor will not keep it hidden.
  5. Repeat for each form you care about. The app cannot add the field to every existing form on its own.

3. Load the form script

Put this script on each page that shows a HubSpot form. On WordPress or a custom site, place it after the official ClickPatrol tag. On a page hosted in HubSpot, paste it under Settings, Content, Pages, Site header HTML.

<script src="https://clickpatrol.com/assets/js/hubspot-form-fill.js?v=20260904b" defer></script>

The script reads ClickPatrol_Legitimate and ClickPatrol_Suspicious from the dataLayer. It writes safe or suspicious into the hidden field. The internal tag value fake becomes Suspicious. If the tag never fired, the field stays empty.

4. HubSpot-hosted sites without a tag

If the form lives on a HubSpot page and you do not already use Google Tag Manager, paste your Unique ID in the app settings and add the header snippet shown there. That snippet does not replace a tag that is already running.

Find the Unique ID in the ClickPatrol dashboard under Integration, then Google Tag Manager.

Test with ?source=f on a public page. You should see a ClickPatrol event in the dataLayer.

5. How sales uses the label

  1. Open a contact that came from a classified form.
  2. Read ClickPatrol traffic: Safe or Suspicious.
  3. Add the ClickPatrol traffic card to the contact sidebar if you want it in one place. Super Admins do that under Customize on the record.
  4. Do not phone Suspicious contacts as a first step.

Disconnect and uninstall

In the app, click Disconnect HubSpot. That calls HubSpot’s uninstall endpoint and deletes the token file we store for that account. The ClickPatrol traffic property stays on the account until you delete it in HubSpot settings.

You can also remove the app from Settings, Integrations, Connected apps in HubSpot. Our webhook then deletes the local token file.

What this does not do

  1. It does not inject the tag into Site header HTML for you.
  2. It does not turn HubSpot CAPTCHA on or off.
  3. It does not write to Google Ads or change HubSpot Auto Tracking. If you use both ClickPatrol and HubSpot ads tracking, merge the templates. Guide: Combining ClickPatrol with HubSpot.
  4. It does not label visits that never came from an ad.

Support

Questions: contact ClickPatrol. Privacy: privacy policy. Terms: terms.