Add HubSpot Meetings Booking Action

The HubSpot Meetings action allows your AI agent to check availability on one of your HubSpot meeting links and help visitors book a meeting directly through the chatbot. Each booking creates or updates the contact in HubSpot and records the meeting on the contact’s timeline. If the link owner has a calendar connected in HubSpot, the meeting is added to that calendar too.

​

Before You Start

• Your HubSpot account must be on a Professional tier or higher. The permission that reads meeting links is not available on Free or Starter accounts.
• You need at least one meeting link in HubSpot. Meeting links are managed under Sales > Meetings Scheduler in your HubSpot account.
• The owner of the meeting link should have their calendar connected in HubSpot, so booked meetings land on their calendar.
• The chat asks visitors only for their name and email. Custom questions on the meeting link are not asked, so make any required custom questions optional. Turn off the consent checkbox on the link too, because the chat cannot collect it.

​

Adding the HubSpot Meetings Action

If the optional permission is locked and cannot be ticked, a HubSpot Super Admin needs to enable it first. In HubSpot, go to Settings > Integrations > Connected Apps, open the Approved apps tab, click Manage access next to SiteSpeakAI, and turn the permission on under Data Permissions. Then click Connect HubSpot Account again.

---

​

Configuration

​

Name

Fixed as book_hubspot_meeting. It cannot be changed.

​

Description

A description of the action and when it should be used. The default description guides the agent on how to handle booking requests, date ranges, and displaying available slots.

​

Hubspot Account

Connects your HubSpot account via OAuth. Once a meeting link is selected, the button reads Reconnect HubSpot Account. Click it to switch to a different meeting link or to authorize HubSpot again. On an installed action, the new link is not saved until you click Update, and any unsaved edits on the page are lost when you leave for HubSpot.

---

​

How Bookings Work

1. Visitor asks to book a meeting
2. Agent shows available time slots in a calendar
3. Visitor selects a date and time
4. Visitor fills in their name and email
5. The meeting is booked on your HubSpot meeting link

Meeting links that offer more than one duration are booked at the shortest duration. Bookings appear in HubSpot as meetings on the contact’s timeline. If the link owner has a calendar connected in HubSpot, the meeting is added to that calendar too. HubSpot rejects a booking when it cannot accept the email address, for example an address on a made-up domain. The agent then tells the visitor the booking failed and repeats HubSpot’s reason, so they can try another address.

---

​

Troubleshooting

These errors show on the action page after you click Connect HubSpot Account. No meeting links found in your HubSpot account. Create one under Sales > Meetings Scheduler, then connect again. Create a meeting link in HubSpot, then click Connect HubSpot Account again. HubSpot did not grant access to your meeting links. Tick the optional meeting links permission on the HubSpot screen and connect again. If it cannot be ticked, a HubSpot Super Admin needs to enable it, and your HubSpot account must be on a Professional tier or higher. The optional permission was not granted. Connect again and tick it. If it is locked, see the Super Admin steps above. If your HubSpot account is on a Free or Starter tier, the permission is not available and the action cannot be used. Could not load the meeting links from your HubSpot account. Please try connecting again. HubSpot returned an error while the meeting links were being read. Wait a moment and click Connect HubSpot Account again. You have reached the maximum number of actions for your subscription. Please upgrade your subscription to add more actions. Your plan’s action limit is reached. Delete an action you no longer use, or upgrade your plan.

---