Skip to main content

HubSpot

Lets an agent read and write CRM data in HubSpot.

What it can do​

  • Contacts: create, get_active_contacts, get_contact, update_contact.
  • Companies: create, get_active_companies, get_company, get_company_activity, update_company.
  • Deals: create_deal, list_deals, update_deal, list_pipelines.
  • Tickets: get_tickets, list_pipelines.
  • Generic: search_data (contacts, companies, deals), get_recent_conversations, get_property, associate_records, create_note.

How to get credentials​

Use a HubSpot Private App access token.

  1. Open your HubSpot account → Settings (gear icon) → Integrations → Private Apps.
  2. Create private app, name it, go to Scopes.
  3. Select the scopes the agent needs, at minimum: crm.objects.contacts.read/write, crm.objects.companies.read/write, crm.objects.deals.read/write, tickets, crm.schemas.*.
  4. Create app, confirm, and copy the Access Token (starts with pat-).

Fields to fill in FlyMyAI​

FlyMyAI fieldWhere it comes from
HUBSPOT_ACCESS_TOKENPrivate App → Access Token

Troubleshooting​

  • MISSING_SCOPE — open the Private App in HubSpot, add the scope, re-generate the token if prompted.
  • Custom properties not found — HubSpot uses internal property names (often lowercase, underscores). Use hubspot_get_property to look up the exact name.