Skip to main content
Integrations

GoHighLevel Calendar Booking for Agents

Let a Vapi, Retell AI or ElevenLabs agent offer open times from a GoHighLevel calendar and book callers in, using a Private Integration Token.

Written By voiceaiwrapper

Last updated 26 days ago

Your agent can book appointments straight into a GoHighLevel calendar during a call. It checks which days and times are open, offers a few to the caller, and books the one they choose. If the caller isn't in GoHighLevel yet, a contact is created for them.

There are two ways to set it up:

  • When you create an agent with VAW Assistant. Works on Vapi, Retell AI and ElevenLabs. The tools are created and attached to the agent for you.
  • From the Tools page of your Pod. Works on Vapi and ElevenLabs, for agents you already have.

Applies to: Vapi, Retell AI and ElevenLabs Pods (an engine or provider connection). VAW Native agents book through Cal.com instead. See Book Appointments with Cal.com.

Before you start

You'll need three things from GoHighLevel:

  • A Private Integration Token. In GoHighLevel, go to Settings β†’ Private Integrations and create a token with calendar and contact permissions.
  • The Location ID of the sub-account that owns the calendar. Find it under Settings β†’ Business Profile.
  • A calendar in that sub-account, with its working hours set.

You don't need the GoHighLevel integration under Settings β†’ Integrations for booking. Booking uses the token only, so it works whether or not your organization has connected GoHighLevel there, and whether or not your plan includes the GoHighLevel integration.

The token is saved inside the booking tools in your Vapi, Retell AI or ElevenLabs account. Anyone who can open that provider account can see it. Create a token just for booking, so you can revoke it without breaking anything else.

How booking works on a call

Two tools work as a pair:

ToolWhat it does
Check availabilityLooks up open slots. If the caller hasn't named a day, it finds which days are open. Once they pick a day, it gets the times on that day.
Book appointmentBooks the slot the caller chose. It looks the caller up in the sub-account by phone or email, creates a contact if there's no match, then books the appointment on that contact.

During the call, the agent:

  1. Works out which dates to check from what the caller asks for, such as "next Tuesday" or "this week".
  2. Offers two or three times from the part of the day the caller prefers, instead of reading out every opening.
  3. Collects at least the caller's first name and email, and asks for their phone number with the country code.
  4. Reads the phone number and email back to confirm, then books.

The appointment appears in GoHighLevel with the title "Appointment Booked for -" followed by the caller's name.

You don't set dates anywhere. You do set one timezone: the business timezone, which your calendar's working hours are set in. On tools created by VAW Assistant and on ElevenLabs, it decides which day a caller means. On Vapi tools added from the Tools page, it sets the timezone of the date snippet you paste into the agent's prompt. When a caller says they're in a different timezone, the agent reads the times out in theirs.

Option 1: Set it up in VAW Assistant

Use this when you're creating a new agent. It's the only way to add GoHighLevel booking on Retell AI. VAW Assistant needs a plan that includes VAW Assistant, and after your organization's first 3 agents it needs your own OpenAI key. See Connect Your OpenAI Key.

  1. Start VAW Assistant from your Pod's Assistants (Vapi) or Agents (Retell AI, ElevenLabs) page. See Build a Provider Agent with VAW Assistant.
  2. On the Business step, set Timezone to the timezone your calendar's working hours use. The booking tools use it as the business timezone.
  3. On the Tools step, turn on GoHighLevel appointment booking ("Offers open days and times from a GoHighLevel calendar, then books the caller in.").
  4. Enter the Private Integration Token and the Location ID.
  5. Wait a moment. The calendars in that sub-account load into Calendar on their own. Pick the one the agent should book into.
  6. Finish the wizard and create the agent.
VAW Assistant on the Tools step for a Retell AI Pod, with the GoHighLevel appointment booking card switched on: Private Integration Token (masked), Location ID (blurred), the Calendar dropdown open with two or three calendars listed, and the note 'Times use the business timezone you set in Business details. The agent works out which days to check from what the caller asks for.' below. The Cal.com appointment booking card above is switched off.

An agent can have only one booking calendar. If Cal.com appointment booking is on, the GoHighLevel switch is greyed out with "Turn off Cal.com booking to use GoHighLevel instead β€” an agent can only have one booking calendar."

VAW Assistant creates both tools in your provider account, attaches them to the agent, and adds the current date and time to the agent's prompt. You don't need to do anything else before testing.

Option 2: Add the tools from the Tools page

Use this for an agent you already have on Vapi or ElevenLabs. You create two tools, then attach them to the agent in your provider dashboard.

Create the availability tool

  1. Switch to your Vapi or ElevenLabs Pod and open Tools in the sidebar. Vapi titles the page Tools & Functions; ElevenLabs titles it ElevenLabs Tools.

  2. Click Add Tool, then choose GHL Check Availability under GoHighLevel.

  3. On step 1, Details, fill in:

    FieldWhat to enter
    Function NameThe name the agent uses to call this tool. It starts as ghl_check_availability. Use 1 to 64 letters, numbers, underscores or hyphens.
    Private Integration TokenYour token. It starts with pit-.
    Location IDThe sub-account's Location ID.
    Business timezone"The timezone this calendar's working hours are set in." It starts as your browser's timezone.
  4. Copy the snippet in the Important box. The agent needs it in its prompt (see below).

  5. Click Continue. VoiceAIWrapper loads the calendars in that sub-account.

  6. On step 2, Pick Calendar, choose the calendar under Choose a calendar. Each one shows its type, such as Round Robin or Personal, and its ID.

  7. Click Save Tool. You'll see Tool created successfully.

A Vapi Pod's Tools & Functions page with the Add Tool sheet open on GHL Check Availability, step 1 (Details): the 1 Details / 2 Pick Calendar step indicator, Function Name showing ghl_check_availability, a masked Private Integration Token, a Location ID filled in, Business timezone set (for example America/New_York), the yellow Important box with the date snippet, the blue Decided during the call box, and Cancel and Continue in the footer. Keep the token masked and blur the Location ID.

A Personal calendar is one person's own diary, not a shared booking calendar. Pick it only if that's really where bookings should go.

Create the booking tool

Click Add Tool again and choose GHL Book Appointment. Its name starts as ghl_book_appointment. Enter the same token, Location ID and business timezone, and pick the same calendar. A booking tool on its own can't work: it can only book a slot the availability tool returned earlier in the call.

Attach the tools and add the date

  1. In your Vapi or ElevenLabs dashboard, open the agent and add both tools to it.
  2. Paste the snippet from the Important box into the agent's system prompt. Without it, the agent doesn't know today's date and can look up the wrong year. You can also edit the prompt from VoiceAIWrapper. See Edit Prompts and Greetings for Provider Agents.

For the full Tools page walkthrough, including Cal.com, see Add Booking Tools to Vapi and ElevenLabs Agents.

Test a booking

Call the agent and ask for an appointment. It should offer open days or times, confirm your details and book.

Test bookings are real. They appear in your GoHighLevel calendar, and a contact is created in the sub-account if your phone number and email don't match an existing one. Use your own details and cancel the appointment afterwards. Test calls use minutes on your provider account.

Troubleshooting

The token works, but the sub-account has no calendars, or the Location ID belongs to a different sub-account. Check the ID under Settings β†’ Business Profile in GoHighLevel. In VAW Assistant the message reads "No calendars found for that Location ID."

VoiceAIWrapper couldn't reach GoHighLevel with the token and Location ID you entered. Check that you copied the whole token, that it hasn't been deleted, and that it has calendar and contact permissions.

  • Check that the agent's prompt includes the current date. Agents created with VAW Assistant have it already; for tools added from the Tools page, paste the snippet from the Important box.
  • Check that the business timezone matches the timezone of the calendar's working hours.
  • Check the calendar's availability settings in GoHighLevel.

By design, the agent never tells callers why a day has no times. It can't tell a closed day from a fully booked one, so it offers another date instead.

The slot was probably taken between checking and booking. The agent checks availability again and offers something else. If every booking fails, check that both tools use the same calendar and that the token has contact permissions, since booking creates or finds the caller's contact first.

The caller is matched by phone number or email. A phone number without its country code may not match the existing contact. The agent is told to always confirm the country code, so check your prompt doesn't tell it to skip that.

In the client portal, VAW Assistant doesn't load the calendar list, so the client types the Calendar ID instead. They can copy it from the calendar's settings in GoHighLevel.