Hotmart Integration
Learn how to set up OneClick Tracking in Hotmart.
OneClick Tracking is a new feature for Meta Ads advertisers who use Hotmart as their payment gateway. It provides immediate and accurate conversion tracking.
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 real volume of conversions per period right in your Ads Manager, making audits quick and clear, with no need for complicated dashboards that have to be kept up to date.
Using the webhook from your Hotmart account, OneClick takes into account both UTM data and Meta’s data, without duplicating conversions. Each ad account gets a unique link, and you can link multiple products (order bumps, downsells or upsells).
Note: OneClick Tracking removes the need for extra tracking tools!
How to Plug OneClick Tracking into Hotmart
Section titled “How to Plug OneClick Tracking into Hotmart”-
Log in to your OneClick Ads account.
-
Go to the "OneClick Tracking" tab, available in the left sidebar of OneClick Ads.

-
Click "New Integration".
-
Select the "Digital products" product type and click Continue.
-
Select the "Hotmart" platform and click Continue.
-
Copy the Webhook URL and add it in Hotmart following the steps below: a. Each ad account gets a unique, automatically generated link. b. This link is what connects your account to Hotmart and tracks conversions by UTM.
6.1. Log in to your Hotmart account. a. Go to “Ferramentas” (Tools) > “Ver Todas” (See All) > Webhooks in the Hotmart menu.

6.2. Create a new Webhook. a. Choose a single product you want to track. We always suggest enabling tracking only for the main product of each funnel. If you want to add other products, repeat steps 6.1 to 6.4 (creating a new webhook for each product separately!). b. Paste the tracking link provided by OneClick (step 6) into the URL field.

6.3. Select the events that should trigger the Webhook. a. Check “todos os eventos” (all events) for purchases.

6.4. Accept the terms and save the configuration. a. You don’t need to send “eventos de teste” (test events), so just finish the process in Hotmart.
-
Copy the UTM Script generated in OneClick Tracking.

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

- Add the UTM Passthrough Script to all your sales pages, so the UTMs are carried through to the final checkout page: a. You can install it on your website via Google Tag Manager or, preferably, directly in your website's header.
-
Set the Attribution Mode.
- Watch this video to understand each model.
- Click Continue.

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

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.

Important Notes
Section titled “Important Notes”-
Install and keep your pixel in your Hotmart settings.
-
Suggestion: Avoid sending order bump or upsell data, to keep the optimization of your entry product clean. Even so, if you still prefer, you can also create webhooks for additional products.
-
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.
-
If you want, you can link multiple products by pointing them to the same Webhook link provided by OneClick Ads.
Hotmart token (hottok)
Section titled “Hotmart token (hottok)”Every Hotmart delivery carries a security token (your account’s hottok). OneClick Tracking learns that token from the first sale it receives and, from then on, refuses deliveries with a different token — so no one can record fake sales in your tracking. The token is only used for that check and is not kept in the sale’s data.
If you generate a new token in Hotmart, the following sales are refused and the integration’s card on the OneClick Tracking page shows the warning “A Hotmart está enviando um token diferente do que aprendemos” (Hotmart is sending a token different from the one we learned), with the date of the refusal. To fix it:
- On the Hotmart integration card, click Reaprender token (re-learn token) and confirm.
- The next sale Hotmart sends teaches the new token.
- Sales refused in the meantime are recorded again when Hotmart resends them — it retries deliveries that failed.
Only use Reaprender token if you were the one who changed the token. If you changed nothing in Hotmart and the warning shows up, contact our support first.