---
title: "Hotmart Integration"
description: "Learn how to connect OneClick Tracking to Hotmart via webhook to track real conversions in your Meta Ads campaigns based on UTMs."
---

> 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!

---

:::tip[You can connect several platforms at the same time]
OneClick Tracking lets you connect **more than one platform to the same ad account** at the same time (for example, Hotmart and Eduzz together). Each platform has its own integration — with its own Webhook link or access credential — and they coexist without competing with each other; just repeat the **"New Integration"** steps for each one you want to connect.

Each sale is attributed to the right campaign by its **UTM**, not by the platform. So if one campaign sells through one platform and other campaigns sell through another, each conversion is automatically linked to the campaign it came from, regardless of which platform generated the sale. The recommended setup is **each campaign serving a single platform** — avoid having the same campaign sell on two platforms at once.
:::

## How to Plug OneClick Tracking into Hotmart

1. Log in to your OneClick Ads account.
2. Go to the "OneClick Tracking" tab, available in the left sidebar of [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking).

   ![The OneClick Tracking tab in the OneClick Ads sidebar, with the New Integration card](../../../../../public/oneclick-tracking/common/image-1.png)

3. Click "New Integration".

4. Select the "Digital products" product type and click Continue.

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

6. 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](https://app.hotmart.com/tools/webhook) account.
   a. Go to "Ferramentas" (Tools) > "Ver Todas" (See All) > [Webhooks](https://app.hotmart.com/tools/webhook) in the Hotmart menu.

   ![image2](../../../../../public/oneclick-tracking/hotmart/image-1.png)

   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.

   ![image3](../../../../../public/oneclick-tracking/hotmart/image-2.png)

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

   ![image4](../../../../../public/oneclick-tracking/hotmart/image-3.png)

   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.

7. Copy the UTM Script generated in OneClick Tracking.

   ![The UTM parameters step of OneClick Tracking, with the parameter to copy](../../../../../public/oneclick-tracking/common/image-2.png)

   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](../../../../../public/oneclick-tracking/common/image-3.png)

8. 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.

9. Set the Attribution Mode.
   - [Watch this video](https://www.youtube.com/watch?v=JgWkvv4ZNLY) to understand each model.
   - Click Continue.

   ![The Attribution Mode step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-4.png)

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

:::caution[Campaign renaming depends on processed conversions]
The naming set here **will only be applied to the campaign name in Ads Manager once there is at least 1 processed conversion**. Receiving raw webhook data from the integrated platform is not enough — the system must have structured the conversion and attributed it to a campaign. If the webhook is arriving but the campaign name hasn't changed yet, wait for the first conversion to be recorded.
:::

![The Campaign Naming step of OneClick Tracking](../../../../../public/oneclick-tracking/common/image-5.png)
![Analysis periods and the Naming Convention preview](../../../../../public/oneclick-tracking/common/image-6.png)

---

## Done!

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](../../../../../public/oneclick-tracking/common/image-7.png)

---

## 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)

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:

1. On the Hotmart integration card, click **Reaprender token** (re-learn token) and confirm.
2. The next sale Hotmart sends teaches the new token.
3. 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.
