Home Tools and integrationsHow do I integrate my Hotmart sales data with Google Sheets?

Find your question in the Help Center

How do I integrate my Hotmart sales data with Google Sheets?

Managing the results of a digital business requires organization and quick access to sales information. To make this process easier, Hotmart offers direct integration with Google Sheets through an extension. By centralizing your sales and subscription data in one place, you gain the flexibility to build custom dashboards, analyze your product’s performance, and track revenue growth without having to manually export reports every day.

In this article, you'll learn in detail how the Google Sheets add-on works. You'll find step-by-step instructions on how to install it in your Google environment, generate the necessary credentials within the Hotmart platform, and connect both tools. 

 

What is Hotmart for Sheets and how does it work?

Hotmart for Sheets is an extension designed to connect your creator account directly to Google Sheets. This tool eliminates the repetitive task of downloading CSV or XLSX files from the platform to update your internal records. Once the connection is established, the extension imports your transaction history directly into the spreadsheet of your choice.

The integration works through security keys generated in your user account. These keys ensure that only your spreadsheet has authorized access to read sales data from the platform. 

It's important to note that the add-on was designed to consolidate structured revenue data, transaction statuses, and basic buyer identification information, serving as a reliable database for your financial management.

 

How do I install the add-on in Google Sheets?

The first step of the setup process takes place directly within Google Sheets. Installation is completed through the Google Workspace Marketplace.

  1. Open Google Sheets and create a blank spreadsheet where you want to centralize your business data.
  2. In the top menu, click Extensions (or Add-ons) and then select Add-ons > Get add-ons.
  3. In the search bar of the Google Workspace Marketplace window, type Hotmart for Sheets.
  4. Click the official Hotmart add-on and then select Install.
  5. Google will request the necessary permissions so the add-on can write data to your spreadsheet. Click Continue, select the appropriate Google account, and click Allow.

Once the process is complete, you'll see a confirmation message indicating that the installation was successful.

 

How do I create access credentials on the Hotmart platform?

With the extension installed in your browser, the next step is to generate credentials in Hotmart so the spreadsheet knows which account to retrieve information from.

  1. Log in to your Hotmart account at https://app.hotmart.com.
  2. In the left-hand menu on the main screen, click Tools.
  3. From the list of available tools, locate and select Hotmart Credentials.
  4. In the top tab, make sure you are viewing the correct environment and click + Create Credential.
  5. Assign a clear name to your credential (for example, "Sales Spreadsheet Sheets") and click Confirm.
  6. The screen will display three essential codes: Client ID, Client Secret, and Basic. Copy these codes and download the information, as you won't be able to view them again after completing the creation process.

 

How do I complete the connection between Hotmart and my spreadsheet?

Now that you have installed the add-on and generated the security keys, you only need to complete the final connection within Google Sheets.

  1. Return to the blank spreadsheet you created at the beginning of the process.
  2. Click Extensions again in the top menu, locate Hotmart for Sheets, and click Open.
  3. A sidebar will appear on the right side of your spreadsheet with authentication fields.
  4. Carefully enter the Client ID, Client Secret, and Basic codes generated in your Hotmart account. Make sure not to copy any extra spaces before or after the values.
  5. Click Submit.

The system will validate the information with Hotmart's servers. If everything is correct, the extension will display a success message and unlock the search screen so you can start importing your product data.

 

Frequently Asked Questions:

Does the Google Sheets integration have any additional cost?

No. The official Hotmart for Sheets add-on and the creation of access credentials within the platform are completely free resources available to all Hotmart creators.

Can I connect more than one product or more than one account to the same spreadsheet?

The extension's standard structure authenticates through user credentials. This means that when you enter your account credentials, the spreadsheet will have access to the consolidated sales data of all products associated with that creator profile.

If you need to separate data by product, you can use the built-in search filters available in the extension's sidebar before importing the information into your spreadsheet.

How often is the data sent to the spreadsheet updated?

The database used by the extension operates on a scheduled synchronization routine. Although communication is automated, there may be a natural processing delay between a sale being approved in the payment system and the new record appearing in Google Sheets. 

To avoid temporary credential blocking due to excessive access requests, it's recommended not to force repeated requests within short periods of time.

Why doesn't some information, such as the buyer's phone number, appear in the spreadsheet?

For security compliance reasons and due to the extension's standard architecture, Hotmart for Sheets does not import buyers' phone numbers

The tool's data scope is limited to basic transaction information, identification email addresses, and billing data.

If collecting a buyer's mobile phone number or WhatsApp number is essential to your business strategy (such as for cart recovery automations or student groups), you can configure an integration through Webhooks or use the Hotmart Developers APIs. Before doing so, make sure the phone field is set as required in your Checkout layout settings.

What should I do if my spreadsheet stops updating automatically?

If your dashboard or sales list is no longer receiving new data automatically, the most likely cause is an expired or unstable communication token between Google and the Hotmart Gateway. To resolve this issue, follow these reconfiguration steps:

  1. In the affected spreadsheet, go to Extensions > Hotmart for Sheets > Open.
  2. If the sidebar indicates that the connection has been lost or displays an error message, disconnect the current account.
  3. Access your Hotmart account, go to Tools > Hotmart Credentials, delete the old credential, and create a new one from scratch, generating new Client ID, Client Secret, and Basic values.

Enter the newly generated credentials into the Google Sheets sidebar and click Submit. This process will renew the security permissions and restore the extension's automatic synchronization flow.

Do you need to talk to us?

If you have any further questions, please contact us and we'll get back to you as soon as possible