Setup Steps
Create a Private App
- Log in to HubSpot
- Go to Settings → Integrations → Private Apps
- Click Create a private app
- Name it (e.g., “Spike Forms”)
- Under Scopes, enable:
crm.objects.contacts.writecrm.objects.contacts.read
- Click Create app
- Copy the Access Token
Configure in Spike
- Go to your Spike Dashboard
- Select your form → Settings
- Scroll to Integrations → HubSpot
- Enable the toggle
- Enter your API Key (Access Token)
- Save changes
Field Mapping
Spike maps form fields to HubSpot contact properties:| Form Field | HubSpot Property |
|---|---|
email | Email (required) |
name or first_name | First name |
last_name | Last name |
phone | Phone |
company | Company |
website | Website |
message | Notes |
Duplicate Handling
If a contact with the same email already exists, HubSpot will update the existing contact instead of creating a duplicate.Troubleshooting
Contacts not created
Contacts not created
- Verify the Access Token is correct
- Ensure the private app has contact write permissions
- Check that the email field is present
Missing properties
Missing properties
- Standard HubSpot properties are mapped automatically
- Custom properties require additional configuration
Token expired
Token expired
Private app tokens don’t expire, but they can be rotated. Update the token in Spike if you regenerate it.