HubSpot - BoostGPT Documentation

Contacts, companies and deals. Who asked, what they asked about, and whether it ever closed.

Connecting

In the dashboard, open Connectors, find HubSpot and press Connect. The key you enter is checked against HubSpot before anything is saved, so a key that is refused never becomes a connection that fails later.

What you will need

Field	What it is
Access Token	Your HubSpot API key or private app access token

Getting the credential

Log in to HubSpot
Go to Settings → Integrations → Private Apps
Click Create a private app
Configure app name and description
Select required scopes:
- crm.objects.contacts.read/write - Contact management
- crm.objects.companies.read/write - Company management
- crm.objects.deals.read/write - Deal management
- transactional-email - Send emails
Install the app and copy the access token

What an agent can do with it

Tool	What it does
`get_contacts`	List contacts
`get_contact`	Get contact by ID
`create_contact`	Create a new contact
`update_contact`	Update an existing contact
`delete_contact`	Archive a contact
`search_contacts`	Search for contacts
`get_companies`	List companies
`create_company`	Create a new company
`get_deals`	List deals
`create_deal`	Create a new deal
`get_pipelines`	Get deal pipelines
`get_owners`	List owners
`get_properties`	Get properties for an object type
`create_engagement`	Create an engagement (note, email, call, etc.)
`get_activities`	Get activities for a contact
`send_email`	Send a single email
`get_email_events`	Get email events

Useful resources

HubSpot documentation