> For the complete documentation index, see [llms.txt](https://docs.praiz.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.praiz.io/integrations/connect-your-crm/hubspot.md).

# Connect HubSpot

Connect HubSpot to Praiz: notes, standard and custom properties on contacts, companies and deals.

## Before you start

* Be a Praiz admin to turn on "CRM admin mode".
* A HubSpot account with the rights to install applications.
* HubSpot records created before the conversations.
* The rules common to every CRM are on the [Connect your CRM](https://docs.praiz.io/integrations/connect-your-crm.md) page.

## Connect HubSpot

### For the whole workspace

1. Open "Settings", "Integrations" tab.
2. On the "CRM" card, turn on "CRM admin mode".
3. In "Connection owner", choose the admin who owns the connection.
4. Click "Connect" and select HubSpot.
5. Allow access in the HubSpot window.

What to expect: the "CRM" card shows "Connected". The "CRM Connection" column of "Users & Teams" shows HubSpot for every member of the workspace.

![Integrations tab in Settings, CRM card](https://3785996597-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FtOw7B6Sc94pXU8vLJs0a%2Fuploads%2Fby65WSRozKeFz637CYZC%2Fen-05-settings-integrations.png?alt=media)

### Per user

Leave "CRM admin mode" off. Each member opens "Settings", "Integrations" tab, clicks "Connect" and selects HubSpot, with the same email address as in HubSpot.

## What Praiz writes

| HubSpot object               | Supported |
| ---------------------------- | --------- |
| Notes                        | Yes       |
| Contacts                     | Yes       |
| Companies                    | Yes       |
| Leads                        | Yes       |
| Deals                        | Yes       |
| Activities (calls, meetings) | No        |
| Custom objects               | No        |

Property types that can be filled in: text, long text, number, boolean, single-select list, multi-select list, date, checkbox. Custom properties are supported as soon as they exist in HubSpot.

You choose the content sent in each agent, "Fields" tab: "Push to CRM notes" for the call note, "Push field to CRM" for a HubSpot property (object, then target property). See [CRM sync](https://docs.praiz.io/automate/crm-sync.md).

## Writing rules

You choose, field by field, what happens when a HubSpot property already has a value. The four fill modes are described on the [CRM sync](https://docs.praiz.io/automate/crm-sync.md) page.

## Automatic and manual sync

Praiz sends the data when an agent applies to a call under its automation rules, or when you click "Send to CRM" on the call page. The details are on the [Connect your CRM](https://docs.praiz.io/integrations/connect-your-crm.md) page.

## Troubleshooting

* The type of the Praiz field does not match the type of the HubSpot property: the property stays empty. Align the two types.
* The field is not set up in "Push field to CRM": open the agent, "Fields" tab.
* The record was created after the conversation: Praiz does not resync past conversations.
* In per-user mode, the member is not connected: check the "CRM Connection" column of "Users & Teams".

## Related pages

* [Connect your CRM](https://docs.praiz.io/integrations/connect-your-crm.md)
* [CRM sync](https://docs.praiz.io/automate/crm-sync.md)
* [My notes don't show up in my CRM](https://docs.praiz.io/troubleshooting/my-notes-dont-show-up-in-my-crm.md)
