---
title: "How to push HG Intelligence to your integrations"
slug: "how-to-push-madkudu-intelligence-to-your-integrations"
updated: 2025-12-19T11:32:20Z
published: 2025-12-19T11:32:20Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.madkudu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to push HG Intelligence to your integrations

You've set up your first model(s) in HG Data Studio and are now ready to segment your Leads, Contacts, or Accounts directly in your CRM, MAP, or Data Warehouse? Here is how to proceed!

## Supported integrations

With HG you can build person-level or account-level segmentations. By segmentation, we mean models, computations, and aggregations. Here are the **supported destinations and objects** where you can push these segmentations to.

|  | **Person** | **Account** |
| --- | --- | --- |
| Salesforce | ✅ Lead & Contact | ✅ Account |
| HubSpot | ✅ Contact | ❌ Company |
| Segment | ✅ Identify | ❌ Group |
| Amazon S3 | ✅ Contact | ❌ Account (Coming soon) |
| Intercom | ✅ Contact (Lead, visitor, user) | NA |
| Eloqua | ✅ Contact* (custom setup) | ❌ Account |

You can also use [HG Persons or Companies API](https://developers.madkudu.com/#companies) to access your Customer Fit or Computations result. Behavioral segmentations (likelihood to buy models and aggregations) aren't available in the API.

# **How to start pushing HG data to your integrations?**

1. Make sure you have **connected your integrations to HG** in the Integrations section in your account. Please refer to the [Integrations docs](/v1/docs/what-signals-does-madkudu-capture) for instructions.
2. Create or make sure the **HG fields are present in your CRM**.
  - [HG fields in Salesforce](/v1/docs/how-to-create-madkudu-fields-in-salesforce)
  - [HG fields in HubSpot](/v1/docs/madkudu-fields-in-hubspot) (if you have connected HG to HubSpot from HubSpot, the fields should have been created automatically)
  - [HG fields in Eloqua](/v1/docs/madkudu-fields-in-eloqua) For the other integrations (**Segment, Intercom**) you can skip this step as they get automatically created when connecting the destination to HG. Please refer to the [specific article about Segment](/v1/docs/segment-1) integration. For **Amazon S3** there is no concept of fields to create since the data will be in the form of files dropped into your S3 bucket. However, you can refer to t[his article to understand the data format pushed](/v1/docs/madkudu-field-names-and-specifications).

## To push a Person-Level segmentation

To push to Amazon S3 or Eloqua, or if you already have a customer fit model pushed to any of the supported integration and would like to push a new one, p*lease open a ticket***as the setup needs to be enabled by our team.

To push to **Salesforce**, **HubSpot**, **Segment** or **Intercom**, please follow the instructions below.

### **Pre - requisites**

- You have the [permissions of an Admin](/v1/docs/user-roles-permissions) in your HG account

Ready? Let's go!

1. Connect to your [HG account](https://app.madkudu.com/) and head to **Settings > Push**
2. Click on **Get started**
3. Select the segmentations to push

![](https://cdn.document360.io/a55e7ea5-b8ac-4456-874d-10cc92097370/Images/Documentation/image(155).png) ![mceclip0.png](https://support.madkudu.com/hc/article_attachments/4690687063949)
4. Click **Confirm**
5. Select the destinations to push the segmentations to ***Tip****: You can decide to push only to 1 system and then synchronize the data to your systems together on your end, or push to multiple destinations HG data. If you choose to push to multiple destinations, make sure that internal sync processes on your end are not overwriting the MadKud fields to avoid discrepancies due to latencies.*

![](https://cdn.document360.io/a55e7ea5-b8ac-4456-874d-10cc92097370/Images/Documentation/image(156).png) ![mceclip1.png](https://support.madkudu.com/hc/article_attachments/4690696830733)
6. Click on **Confirm**
7. Follow the instructions on the screen for each destination to
  1. **map the fields to be populated**
  2. select **which records to score**: all the database of lead or contact in your system will be scored and get updated on an ongoing basis. Or you can choose for Salesforce and HubSpot to score only records created after a certain date. [Learn more about realtime & batch scoring and rate limiting](/v1/docs/batch-versus-real-time-scoring-in-your-integrations). ![mceclip2.png](https://support.madkudu.com/hc/article_attachments/4690935061517) Please note that for **Segment**, only records active in the last 1 to 90 days (timeframe you can customize) can be scored.
8. Review your mapping and conditions
9. Click on **Start syncing** to complete the setup. HG will start scoring records in your integrations at the [next sync process.](/v1/docs/how-to-read-the-processes-page-how-long-does-it-take-for-madkudu-to-score-my-leads-and-accounts) ![](https://cdn.document360.io/a55e7ea5-b8ac-4456-874d-10cc92097370/Images/Documentation/image(157).png)![mceclip4.png](https://support.madkudu.com/hc/article_attachments/4691114675085) Then HG will process your data continuously, scoring new records created in realtime and updating existing records at every sync process if any new data is available to push. [Learn more about realtime & batch scoring and rate limiting](/v1/docs/batch-versus-real-time-scoring-in-your-integrations).

In the integrations where a push is set up you'll see the field mapping in the integration's page

![](https://cdn.document360.io/a55e7ea5-b8ac-4456-874d-10cc92097370/Images/Documentation/image(158).png)![mceclip3.png](https://support.madkudu.com/hc/article_attachments/4691089625869)

Et voila, check back in your integration when the data starts flowing!

## To push an Account-level segmentation

Only push to Salesforce is available.

*Please open a ticket* with the following information and we'll set it up for you.

- Model(s), computations or aggregations to push
- API name of the fields to push to (if different from [the suggested names](/v1/docs/how-to-create-madkudu-fields-in-salesforce))

# **F.A.Q**

### **Can HG sync data to my integrations only at fixed hours?**

No, HG processes your data continuously in batch and pushes updates every 4h to 12h. This allows pushing updates frequently to make sure your team can react quickly to hot qualified leads or accounts. Updates would occur in more than 4h apart when there are a lot of new data to process or a lot of models to process.

### **How can I turn off the push of HG scores to my integrations?**

- You can either disable in your integration the user associated with HG
- Or *open a ticket* for us to deactivate it on our end.

### **How can I push a multi-fit/second fit model to my integrations?**

After [deploying your multi-fit model](/v1/docs/deploying-a-multi-fit-model) from the Studio, please open a ticket explaining:

- the multi-fit model that you'd like to start pushing
- the integration that will get the HG intelligence
- the name of the [HG fields](/v1/docs/madkudu-field-names-and-specifications) in your integration

### **Can I push a second likelihood to buy model to my integrations?**

HG does not support deploying in the Studio nor pushing additional likelihood to buy models, beside:

- 1 Lead Likelihood to Buy model
- 1 Account Likelihood to Buy model.
