HubSpot Integration

Connect your HubSpot account to automatically import form submissions, sync contact data, and push grading results back to HubSpot.

Overview

The HubSpot integration provides:

Automatic form import — Pull submissions from HubSpot forms in real-time
Contact sync — Keep contact records in sync between platforms
Score push — Write grading scores back to HubSpot contact properties
Deal creation — Automatically create deals for qualified leads

Setup

Step 1: Connect Your HubSpot Account

Navigate to Dashboard → Connections
Click Connect HubSpot
You'll be redirected to HubSpot to authorize the integration
Select the HubSpot account you want to connect
Grant the requested permissions

Required Scopes:

crm.objects.contacts.read

crm.objects.contacts.write

forms

oauth

Step 2: Select Forms

After connecting, choose which HubSpot forms should feed into Grader.io:

Go to Connections → HubSpot → Forms
Toggle on the forms you want to import
Map each form to a grader

Step 3: Map Fields

Map HubSpot form fields to your grader's expected inputs:

HubSpot Field	Grader Input	Type
`firstname` + `lastname`	`name`	Text
`email`	`email`	Email
`company`	`company`	Text
`annualrevenue`	`budget`	Number
`industry`	`industry`	Category

Step 4: Configure Score Push (Optional)

Push grading results back to HubSpot contact properties:

Create a custom property in HubSpot (e.g.,
```
grader_score
```
, type: Number)
In Grader.io, go to Connections → HubSpot → Score Push
Map
```
grader_score
```
to the Grader.io score output
Optionally map
```
grader_category
```
to a text property

Data Flow

HubSpot Form Submission
        ↓
  Grader.io Webhook
        ↓
  Grader Evaluates
        ↓
  Score & Category Assigned
        ↓
  Results pushed back to HubSpot
        ↓
  HubSpot Workflow Triggered

Webhook Events

The integration fires these events:

```
hubspot.form.received
```
— New form submission imported
```
hubspot.contact.synced
```
— Contact data synchronized
```
hubspot.score.pushed
```
— Score written back to HubSpot

Troubleshooting

"Invalid API Credentials" Error

Ensure your HubSpot API key hasn't expired
Re-authorize the connection from Connections → HubSpot → Reconnect

Forms Not Appearing

Check that the correct HubSpot account is connected
Verify the forms are active in HubSpot
Allow up to 5 minutes for new forms to appear

Scores Not Syncing

Confirm the custom property exists in HubSpot
Check that the field mapping is correct
Review the Activity Log for sync errors

Related: Webhook Setup · API Reference

Documentation