You can wire the HubSpot node into an AI agent as a tool provider: the agent calls the operations you allow. See Agent tools.
Setup Guide
This guide walks you through connecting HubSpot to NoClick and setting up your first automation.Prerequisites
- A HubSpot account with admin access
- A NoClick account
- Understanding of your HubSpot data structure (contacts, companies, deals, etc.)
Step 1: Choose Your Authentication Method
HubSpot supports two authentication methods in NoClick:Option A: OAuth (Recommended)
OAuth is the easiest method and recommended for most users. It requires no manual key copying and automatically handles token refresh. Pros:- Simple one-click authorization
- Automatic token refresh
- Secure credential handling
- Limited to browser-based setup
Option B: Private App Access Token
Use a Personal Access Token (PAT) for server-to-server integrations or headless workflows. Pros:- Works in all environments
- Long-lived credentials (no expiration)
- Fine-grained scope control
- Requires manual token creation and copying
Step 2: Connect Your HubSpot Account
Using OAuth:
- Open NoClick and create a new workflow
- Add a HubSpot node to your canvas
- Click Connect under the Credentials section
- Click Sign in with HubSpot
- Log in to your HubSpot account
- Review the requested permissions and click Install app
- You’ll be automatically redirected back to NoClick with your connection established
Using Private App Access Token:
- Go to HubSpot Private Apps
- Click Create app and name it “NoClick”
- Under the Scopes tab, select the permissions you need:
- For contacts:
crm.objects.contacts.read,crm.objects.contacts.write - For companies:
crm.objects.companies.read,crm.objects.companies.write - For deals:
crm.objects.deals.read,crm.objects.deals.write - For tickets:
tickets - For OAuth:
oauth
- For contacts:
- Click Create app
- Go to the Auth tab and copy your access token
- In NoClick, select the Private App Access Token credential type
- Paste your token in the Private App Access Token field
Step 3: Create Your First Workflow
Basic Example: Create a Contact from Form
- Add a HubSpot node to your canvas
- Select the operation Create Contact
- Fill in the required fields:
- Email: The contact’s email address
- First Name: Contact’s first name (optional)
- Last Name: Contact’s last name (optional)
- (Optional) Add additional fields like phone, company, or custom properties
- Run the workflow to create a contact in HubSpot
Trigger Example: Run workflow when a contact is created
- Add a HubSpot trigger node
- Select On Contact Created or another trigger event
- Configure the trigger (filter by contact properties if needed)
- Add subsequent nodes to process the new contact
- Send an email notification
- Create an associated company
- Add a task for your sales team
Step 4: Configure Your Automation
Common Configurations:
Sync Data Between Systems:- Trigger: Contact created in HubSpot
- Action: Create a record in your CRM or database
- Trigger: Deal moved to specific stage
- Action: Send Slack/Email notification to sales team
- Trigger: Contact property changed
- Action: Update HubSpot contact properties based on engagement
- Use List operations to fetch multiple records
- Process them with filters and conditions
- Perform batch updates
Step 5: Test and Monitor
- Run a test: Click Run to test your workflow
- Check HubSpot: Verify the changes appear in HubSpot
- Monitor execution: View logs in NoClick to ensure workflows complete successfully
- Enable triggers: Once tested, enable any triggers to start automations
- Monitor performance: Check workflow history for errors or issues
Troubleshooting
“Connection failed” error:- Verify your HubSpot account has admin access
- Ensure your Private App token is still valid (hasn’t been revoked)
- For OAuth, try re-authorizing by disconnecting and reconnecting
- Read the error before reconnecting. HubSpot returns the same generic permission error whether the permission is missing or your plan does not cover the feature, so NoClick checks your connection’s actual permissions and tells you which one it is. An error that says your connection already carries the permission is a plan or edition limit, and reconnecting will not change it.
- Ensure your Private App has the required scopes for your operation
- For OAuth, reconnect the credential so the install requests the current permission set
- Check that your HubSpot plan includes the feature the operation uses, since HubSpot skips permissions your tier does not cover
- Upload File brings a file into HubSpot from a URL you provide. Its File Data field takes JSON with the file’s
urland anaccesslevel ofPRIVATE,PUBLIC_INDEXABLE, orPUBLIC_NOT_INDEXABLE, plus an optionalfolderPath,name, andoverwrite. - Create Data Import takes the address of the CSV or spreadsheet to import in its File Url field, alongside the import definition.
- Verify the HubSpot objects (contacts, companies, deals) exist
- Check filters are not excluding all results
- Use Get operation on a specific ID to verify connectivity
Best Practices
- Start Simple: Build one workflow at a time before creating complex automations
- Use Filters: Filter trigger data to reduce unnecessary workflow runs
- Batch Updates: Use batch operations for better performance with large datasets
- Monitor Costs: HubSpot API calls count toward your app’s rate limits
- Backup Data: For critical operations, consider logging changes to a database
- Test Triggers: Always test trigger workflows with sample data before enabling them
Credentials
Connect HubSpot under Credentials in the node settings. See Connecting credentials for the general flow.OAuth
Sign in with your HubSpot account when prompted; no keys to copy. Sign in with your HubSpot account to authorize NoClick. See the setup guide for detailed installation and configuration instructions. Get your credentials here. NoClick requests the following permissions:oauthcrm.objects.contacts.readcrm.objects.contacts.writecrm.objects.companies.readcrm.objects.companies.writecrm.objects.deals.readcrm.objects.deals.writetickets