Skip to content

Install WebDecoy on HubSpot

HubSpot serves your site through Cloudflare, but through HubSpot’s Cloudflare account, where you cannot add anything. Cloudflare’s Orange-to-Orange (O2O) setup puts your own Cloudflare zone in front of it. Your zone runs first, so the WebDecoy edge sensor can run there and see every request to the site: AI crawlers, search crawlers, scrapers and curl.

A script tag alone cannot do this. A browser detection script only runs in clients that execute JavaScript, and GPTBot, ClaudeBot, Googlebot’s crawl pass and most scrapers never do.

  • A Cloudflare account (Free works) with your domain added as a zone, so Cloudflare runs its DNS.
  • The domain connected in HubSpot.
  • A WebDecoy account with this site added under the address visitors use, for example https://www.example.com. Create a free account.

1. Point your hostname at HubSpot through Cloudflare

Section titled “1. Point your hostname at HubSpot through Cloudflare”

In your Cloudflare zone, open DNS → Records and create a record for each hostname you want covered (usually the root and www):

  • Type: CNAME
  • Name: the hostname, for example www
  • Target: see the table
  • Proxy status: Proxied (orange cloud)
Record CNAME target
Your hostname <HUBID>.sites-proxy.hscoscdn<##>.net

The exact target depends on your HubSpot account and proxy settings. HubSpot shows it when you connect the domain; Cloudflare’s guide links HubSpot’s reverse proxy documentation. Cloudflare flattens a CNAME on the root domain automatically.

The orange cloud is required. On a DNS-only record your zone is skipped, and the sensor never runs.

Connect the domain in HubSpot under Settings → Content → Domains & URLs if it is not there yet. Once HubSpot accepts the domain, requests go visitor → your Cloudflare zone → HubSpot’s Cloudflare zone → HubSpot.

  1. In WebDecoy, select the site.
  2. Open Integrations → Cloudflare and choose Connect with Cloudflare, then approve the scopes on Cloudflare’s consent screen.
  3. Open Edge Sensor, choose the zone, and set the route to cover each hostname, for example www.example.com/* and example.com/*.
  4. Select Deploy edge sensor.

No code is involved. The edge sensor guide covers the details, including Worker usage and the static-file paths it skips.

Terminal window
curl -A "WebDecoy-Test/1.0" https://www.example.com/

Swap in your own address. Within a minute a detection labelled Test appears, and Sensors shows the Edge Worker row as Reporting. Then let real traffic arrive: most public sites see search and AI crawlers within hours.

The edge sensor sees every request. The browser detection script adds browser-integrity and behaviour signals from clients that do run JavaScript, such as headless browsers and browser agents. Paste the line from Detection Scripts into HubSpot’s site header HTML setting for your website pages.

  • The sensor does not block. It reports, and it lets the request through on any error of its own. Cloudflare notes that a Worker on the O2O hostname can interfere with traffic; the sensor only changes a response when you turn on enforcement for a path.
  • Zone hold (Cloudflare Enterprise). If HubSpot reports “The hostname is associated with a held zone”, release the hold temporarily (for a subdomain, turn off Also prevent Subdomains), then refresh the domain in HubSpot.
  • Certificates. If you have CAA records, they must allow a certificate authority Cloudflare and the host use (Let’s Encrypt is the usual one), or HTTPS can fail.
  • One edge sensor per organization, today. Other sites in the same WebDecoy organization can report through the WordPress plugin, an SDK or the browser script.
  • Support. For problems in your own Cloudflare zone, Cloudflare Support helps and consults HubSpot where needed.

Verify the install, then see what crawlers did in your site’s first report.