Skip to main content
The HubSpot integration lets your Invoca AI agents read and write live HubSpot data during a conversation. The agent can book meetings on your reps’ calendars and keep each caller’s HubSpot contact record up to date, without a person stepping in. The integration comes as two skills. You can attach either one, or both, to an agent. Setup takes four steps: confirm the prerequisites, connect your HubSpot account, map your CRM fields, and attach the skills to your agent. Both skills work with voice and SMS agents, and share one HubSpot connection and one field mapping.

Before you begin

Check these items before you connect. Most setup problems come from a missing permission or an unsynced calendar.
  • HubSpot is enabled on your Invoca account. The HubSpot option only appears in Manage Integrations once your Invoca team has turned it on for your network. If you don’t see it, contact Invoca.
  • The person connecting has the right HubSpot permissions. They need permission to edit contacts and to install apps in your HubSpot account. If they can’t install apps, HubSpot shows “You don’t have install access for this app” and sends a request to install. A HubSpot super admin must approve that request before the connection finishes.
  • Your reps’ calendars sync with HubSpot (Scheduling only). Each rep must connect their Google Workspace or Microsoft Outlook / Office 365 calendar in HubSpot. Availability comes from that synced calendar.
  • You have a HubSpot scheduling page (Scheduling only). The agent books through a HubSpot meetings link, such as meetings.hubspot.com/your-team. Have the link ready, and check which form fields the page requires.
  • You know which contact fields you want the agent to write (CRM Sync only). You’ll need each field’s HubSpot internal property name, such as lifecyclestage or hs_lead_status. Find these in HubSpot under Settings > Properties.

Connect HubSpot

You connect HubSpot by signing in to HubSpot from Invoca and approving access. Invoca never sees or stores your HubSpot password.
  1. In Invoca, open Manage Integrations and select HubSpot.
  2. Add a new connection.
  3. Sign in to HubSpot when prompted, and choose the HubSpot account you want to connect.
  4. Review the access Invoca is requesting, then approve it.
  5. Back in Invoca, confirm the connection shows as connected.
To test first, connect a HubSpot sandbox account, then add a second connection for your production account when you’re ready to go live. Invoca requests this access in HubSpot:

Map CRM fields

The field mapping tells the agent which HubSpot contact fields it may read and write, and what each one means. The agent ignores any field you leave unmapped, so the mapping is also your main control over what the agent can change. The mapping belongs to the connection, so both skills use the same one. To set it up:
  1. In Manage Integrations, open your HubSpot connection.
  2. Expand CRM Field Mapping.
  3. Select the Contact object, or use Add Object to add it.
  4. For each field, pair an Invoca field with the HubSpot internal property name, such as lifecyclestage. Use the internal name, not the label you see in HubSpot.
  5. Save.
Each object shows a count of mapped fields out of the total, with a status color: When the agent reads a contact, it only uses mapped fields that actually hold a value. If a field is empty, the agent asks the caller instead of guessing.

Add skills to your AI agent

You attach a skill to an action in Agent Builder. The agent then uses that skill when the conversation reaches that action.
  1. Open your agent in Agent Builder.
  2. Open the action you want to connect. Use the Schedule Appointment action for HubSpot Scheduling. HubSpot CRM Sync works on any other action.
  3. In the skill field, choose HubSpot Scheduling or HubSpot CRM Sync, then choose your HubSpot connection.
  4. For Scheduling, give the agent your HubSpot meetings link and its timezone.
  5. Test the agent, then publish it.
The agent picks up your field mapping when you publish. If you change the mapping later, publish the agent again so it uses the new fields.

How Scheduling works

The agent only offers times that HubSpot reports as open, and never books, reschedules, or cancels until the caller confirms the exact date and time. It confirms the caller’s timezone first and gives times in that timezone. A few details to know:
  • Round-robin pages: if your scheduling page rotates between reps, HubSpot picks an available rep for the chosen time.
  • Confirmation emails: booking runs through HubSpot’s own booking flow, so any confirmation email or calendar invite you’ve set up on the page is sent as usual.
  • Canceled meetings stay on calendars: canceling updates the HubSpot meeting record but doesn’t remove the calendar event or invite. The agent tells the caller this. Your team removes the calendar event separately.
  • Partial reschedules: if the new meeting books but the old one can’t be marked Rescheduled, the agent tells the caller the new time is booked and doesn’t claim the change fully worked.

How CRM Sync works

The agent always searches HubSpot before it writes anything, so it doesn’t create duplicate contacts. It updates an existing contact without asking first, but only creates a new contact when the caller has agreed to be contacted.
  1. The caller shares their phone number or email.
  2. The agent searches HubSpot contacts by phone and email.
  3. If a contact is found, the agent updates it with your mapped fields.
  4. If no contact is found and the caller has agreed to be contacted, the agent creates a contact with their phone, name, and email.
  5. If no contact is found and the caller hasn’t agreed, the agent creates nothing.
  • Search: the agent searches with the caller’s phone number and email. Email must match exactly. Phone matches the contact’s phone or mobile phone field in any format. If several contacts match, the agent picks the one whose name matches the caller, or else the most recently updated one.
  • Update: when a contact is found, the agent writes the fields you mapped, such as lifecycle stage, lead status, contact owner, or product interest. It never writes a field you haven’t mapped.
  • Create: when no contact is found and the caller has agreed to be contacted, the agent creates a contact with their phone number, consent, and any name or email they gave. If HubSpot reports the contact already exists, the agent uses that contact instead of creating another.
  • Errors: the agent only says details were saved after HubSpot confirms it. If a save fails, it tells the caller it couldn’t save their details and doesn’t retry with guessed values.

Data and privacy

The agent works with live HubSpot data during the conversation and is built to avoid sharing anything the caller didn’t give it.
  • No reading back stored data. The agent only confirms details the caller already gave. It never reads out other information on the contact, or anything about another person.
  • Mapped fields only. The agent writes only the contact fields in your mapping, and only reads mapped fields when a mapping exists.
  • No made-up results. The agent never says a meeting was booked or a contact was saved unless HubSpot confirmed it.
  • No internal details. The agent doesn’t say internal IDs, field names, or system terms to the caller.
  • Secure sign-in. You connect through HubSpot’s own sign-in and approval. Invoca doesn’t store your HubSpot password. To stop access, disconnect the app in HubSpot, or remove the connection in Manage Integrations.

Limitations

  • Contacts only. CRM Sync works with HubSpot contacts. It doesn’t create or update deals, tickets, or companies.
  • New contacts start small. A new contact is created with the caller’s phone, consent, name, and email. Your other mapped fields are written as updates to an existing contact.
  • Scheduling pages only. The agent books through HubSpot scheduling pages, so it can’t book on a calendar that isn’t synced to HubSpot.
  • Canceling doesn’t clear calendars. A canceled meeting is marked Canceled in HubSpot, but the calendar event and invite stay until someone removes them.
  • Sandbox testing. In a HubSpot sandbox account, HubSpot only lets you book meetings for people who are users in that sandbox. Use your own team’s emails when you test in a sandbox.
  • CRM Sync and Schedule Appointment. HubSpot CRM Sync can’t be attached to the Schedule Appointment action. Attach it to another action in the same agent.

Troubleshooting

Still stuck? Contact Invoca with the agent name and the time of the conversation.
Last modified on November 19, 2026