# Hubspot integration

### 📝 Step 1: Get HubSpot Portal ID (in HubSpot)

1. Log in to your **HubSpot** account
2. Click your **profile picture** (top-right corner)
3. Your **Portal ID** appears in the dropdown

Please follow this [link](https://knowledge.hubspot.com/account/manage-multiple-hubspot-accounts?&_ga=2.213679508.1258595645.1656994320-1460215817.1656259344#check-your-current-account) to know more.

***

### 📝 Step 2: Find or Generate Your Access Token (Private App) (in HubSpot)

Powerful Form uses a **Private App Access Token** to securely send data to HubSpot.

#### ✅ Create a HubSpot Private App + get the token

* In your HubSpot account, navigate to **Settings** > **Integrations** > **Private Apps**.
* Click **Create a private app** > enter a name (e.g., "Powerful Form Integration") and description.
* Under **Scopes**, ensure the following are selected:
  * `forms`
  * `crm.objects.contacts.write`
  * `crm.schemas.contacts.write`
* Click **Create app** > copy the generated **Access Token**.

Please follow this [link](https://developers.hubspot.com/docs/api/private-apps#create-a-private-app) to know more

***

### 📝 Step 3: Add HubSpot Portal ID + Access Token to PowerfulForm (in PowerfulForm)

1. Open the app > **Settings** > **Third party integration** > hover**Hubspot** > click **Config**

   <figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2FtFuc2FRZKU2owXNcfQr8%2F2025-10-07_14-30-05.png?alt=media&#x26;token=61949187-7c17-4657-8561-48136d316a38" alt=""><figcaption></figcaption></figure>

2\. Enter **Hubspot Portal Id** and**Hubspot Private App Access Token >** paste the ID you find in step 1 and 2

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2F2kV5W506dh7C4dam5Kgm%2F2025-10-07_14-30-39.png?alt=media&#x26;token=0bc6a886-af65-4f4e-ab15-026dbcd5c913" alt=""><figcaption></figcaption></figure>

3\. Click **Save** to update the changes

***

### 📝 Step 4: Map form fields to HubSpot (in Form Builder)

This step controls **what gets sent** to HubSpot when someone submits the form.

#### **Before map the data**

please make sure you already create a form in Hubspot to collect customers information. Learn more about [creating a form in Hubspot](https://knowledge.hubspot.com/forms/create-forms#create-a-form)

#### **Mapping steps**

1\. Open the app .> click **Forms** > open the form you want to deal with

2\. Click **Integration** icon on the left side > turn on **Hubspot**  > click on **Hubspot** option

<figure><img src="https://3488889492-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGgRVSDpMlcGFz1igK0s%2Fuploads%2F38Btg0bgswO8LesNfVil%2F2026-01-30_16-50-26.png?alt=media&#x26;token=8dac5abe-27d5-4bd2-a673-f487e49014f3" alt=""><figcaption></figcaption></figure>

3\. Select a form you want from Hubspot

4\. Select the value of the form (on the right) to match with the form field in Hubspot

For example:&#x20;

HubSpot Email ← Form Email

HubSpot First name ← Form First name

HubSpot Last name ← Form Last name

**Note**:

* The **Email** value is compulsory here to create a new profile in Hubspot
* The other values are optional. Please map them based on your needs

5. Click **Save**

***

### ✅ Test & Check Your Results (in HubSpot)

1. Submit your form once using a real email address
2. In HubSpot, go to **Contacts**
3. Confirm the new contact appears (and fields are filled correctly)

<figure><img src="https://da76v9kevdkud.cloudfront.net/wp-content/uploads/2022/09/2024-10-04_15-53-04-1024x564.png" alt=""><figcaption></figcaption></figure>

For example: the **First name**  field of Hubspot is matched with **First name** field of the form, the **Last name**  field of Hubspot is matched with **Last name** field of the form

***

### 🔧Troubleshooting

#### &#x20;“Invalid token” / “Authentication failed”

* Make sure you copied the **Private App Access Token** (not a different HubSpot key).
* Remove any extra spaces when pasting.
* Confirm your Private App includes these scopes:\
  `forms`, `crm.objects.contacts.write`, `crm.schemas.contacts.write`

#### “Portal ID is wrong” / cannot connect

Re-check the **Portal ID** from the profile dropdown in HubSpot.

#### No contacts created after submission

* Confirm HubSpot integration is enabled on the **correct form**.
* Make sure you clicked **Save** after mapping.
* Submit a **new** test entry (older submissions won’t sync automatically).

***

#### Need More Help?

If you still need assistance, please contact us at [**support@powerfulform.com**](mailto:support@powerfulform.com). Our team will be happy to help you resolve any issues or guide you further.