# Integrate Cloud Voice with HubSpot CRM

Linking Cloud Voice to HubSpot CRM (Customer Relationship Management, the system your team uses to track contacts and deals) lets your team place and take calls straight from their extensions while HubSpot stays in the loop. This page walks you through authorizing the connection and matching your HubSpot users to Cloud Voice extensions.

## Prerequisites

- You have [created a CRM application on HubSpot](/pbx/integrations/hubspot/create-a-crm-application-on-hubspot/) with a developer account and configured its authorization settings.
- You are signed in to a [standard HubSpot account](/pbx/integrations/hubspot/hubspot-crm-integration-guide/#about-this-guide__standard-account) that has Super Admin privileges. This is the account you will use to authorize the integration.

## Step 1. Request authorization from HubSpot CRM

1. Sign in to the Cloud Voice management portal and go to **Integrations > CRM**.
2. Select **HubSpot**.

   
   ![Cloud Voice, CRM integration page with HubSpot selected as the provider](/images/pbx/enter-hubspot-crm.png)

3. In the **Authorization** section, enter the credentials from your HubSpot application:

   ![Authorization fields for the Client ID and Client Secret](/images/pbx/pbx-authorization-fillin.png)

   - **Client ID**: Paste the [Client ID](/pbx/integrations/hubspot/create-a-crm-application-on-hubspot/#about-this-guide__ul_x3w_dxk_htb) from your HubSpot application.
   - **Client Secret**: Paste the [Client Secret](/pbx/integrations/hubspot/create-a-crm-application-on-hubspot/#about-this-guide__ul_x3w_dxk_htb) from your HubSpot application.

   :::note
   Both values were generated when you created the HubSpot application in the prerequisites. Copy and paste them rather than typing them by hand: a single wrong character causes the authorization to fail.
   :::

4. Click **Save**. A new browser tab opens and asks you to pick the account to use for the integration.
5. Choose a standard HubSpot account with Super Admin privileges, then click **Choose Account**.

   ![Account chooser for authorizing the integration](/images/pbx/choose-account.png)

   :::caution
   Do not choose a developer account. If you do, the integration will fail.
   :::

   The page then shows the permissions the application is requesting.

6. Review the permissions, select the disclaimer checkbox, and click **Connect app** to grant access.

   ![Permission grant screen with the disclaimer checkbox and Connect app button](/images/pbx/grant-access-permission.png)

   You are sent back to the Cloud Voice management portal, where a pop-up reports the result of the authorization.

   ![Pop-up confirming the authorization was successful](/images/pbx/authorization-confirm.png)

7. Click **OK**. When the **Status** field reads **Connected**, the HubSpot CRM integration is in place.

## Step 2. Match HubSpot users to extensions

1. On the CRM integration page, click the refresh icon ![Refresh](/images/pbx/refresh-firefox.png) next to **HubSpot User** to pull in the current list of HubSpot users.

   ![Syncing the list of HubSpot CRM users](/images/pbx/sync-crm-users-1.png)

2. Pair each HubSpot user with a Cloud Voice extension, either automatically or by hand.

   **Match automatically**

   Use this when a user's HubSpot account and their Cloud Voice extension share the same email address.

   :::tip
   Where the email addresses match, prefer automatic matching. It pairs every user in one step instead of making you set each one by hand.
   :::

   ![Automatic association of HubSpot users and extensions](/images/pbx/associate-auto.png)

   a. Click **Associate Automatically**.

   b. In the pop-up window, click **OK**.

   **Match manually**

   Use this when a user's HubSpot account and their extension have different email addresses.

   
   ![Cloud Voice, manual association of a HubSpot user with an extension](/images/pbx/associate-manual.png)

   a. In the **Extension** drop-down next to the HubSpot user, click the edit icon ![Edit](/images/pbx/edit.png).

   b. In the pop-up window, select the extension(s) for that user.

   c. Click **Confirm**.

3. Click **Save**.

## Result

- Cloud Voice and HubSpot CRM are now integrated.
- HubSpot users can place and receive calls using their Cloud Voice extensions.

## What to do next

- [Set up contact synchronization from HubSpot CRM](/pbx/integrations/hubspot/set-up-contact-synchronization-with-hubspot-crm/)
- [Set up contact creation for HubSpot CRM](/pbx/integrations/hubspot/set-up-automatic-contact-creation-for-hubspot-crm/)
- [Set up call popup](/pbx/integrations/hubspot/set-up-call-popup-for-inbound-calls/)
- [Use the HubSpot CRM integration](/pbx/integrations/hubspot/use-hubspot-crm-integration/)