HqO Help
HqO Help
Breadcrumbs

Tripleseat Integration

Overview

The Tripleseat integration connects HqO's Resource Booking module with your Tripleseat account, allowing Tripleseat-managed event spaces to surface directly in the HqO app and web experience. Availability syncs in real time, so tenants always see an accurate calendar. When a tenant wants to book a Tripleseat resource, they are directed to the Tripleseat lead form to submit their request — the booking is managed entirely within Tripleseat.

How It Works

  • Tripleseat resources appear in HqO alongside your standard bookable spaces.

  • Availability is synced in real time from Tripleseat — any event booked there will show as blocked in HqO automatically.

  • Tenants browse and view availability in HqO, then click Book to be directed to your Tripleseat lead form.

  • Once the lead form is submitted, a confirmation message (configured in Tripleseat) is displayed.

  • Admins cannot book on behalf of users for Tripleseat resources in HqO — the calendar view is intentionally disabled for these resources in the admin portal.

Admin Setup

Prerequisites: Native HqO Resource Booking must be activated before setting up the Tripleseat integration. If it isn't active yet, enable it first in your Resource Booking settings.

Step 1 — Activate the Tripleseat Integration in HqO

  1. Log into HqO Admin and navigate to Resource Booking.

  2. Go to Settings and activate the Tripleseat integration.

  3. Copy the Redirect URI displayed on the activation screen (e.g., https://gohqo.co/apps/resource-booking-v2/setting). You'll need this in the next step.

Step 2 — Create an OAuth Application in Tripleseat

  1. Log into Tripleseat and go to Settings → Tripleseat API & Webhook Details → Tripleseat API OAuth 2.0 Client Applications.

  2. Create a new application and fill in the following fields:

    • Name: HQO Integration

    • Description: HQO <-> Tripleseat integration for resource/event booking synchronization

    • Information URL: https://www.hqo.com

    • Redirect URI: Paste the URI you copied from HqO in Step 1

  3. Under API Scope Permissions, enable the following:

    Write access

    • Events

    • Bookings

    • Tasks

    • Documents

    Read access

    • Leads

    • Contacts

    • Accounts

    • Payments

    • Users

    • Locations

    • Notes

    • Guest Room Blocks

    • Menus

    • Menu Items

    • Menu Updates

    • Webhooks

    • Payment Reports

    • PMS

    • Sites

    Note: Write permission automatically includes read permission for the same resource.

  4. Click Submit to save the application.

Step 3 — Create a Webhook in Tripleseat

  1. In Tripleseat, create a new webhook and enter the following URL: https://webhooks-service.use1.hqo-production.com/webhooks/events/tripleseat/event

  2. Enable the following webhook permissions:

    • Event Actions: Create Event, Delete Event, Reassign Event Location, Status Change Event, Change Event Datetime

    • Room Actions: Update Room, Delete Room

Step 4 — Complete Activation in HqO

  1. Back in Tripleseat, click into the OAuth application and copy the UID and Secret.

  2. Paste the UID and Secret into the HqO activation form and click Activate.

  3. You'll be redirected to Tripleseat to approve the authorization, then brought back to HqO.

Step 5 — Configure and Import Resources

  1. Select a default location and enter your Lead Form URL (this is the Tripleseat lead form tenants will be sent to when they click Book).

  2. Choose which resources to import. You can optionally adjust the Display Name and Resource Type — these can also be edited after import.

  3. Click Import. Note that a resource can only be imported into one building. If a resource has already been imported, it will appear greyed out in the list.

  4. Once imported, you can configure additional settings for each resource including images, descriptions, cross-building sharing, availability display, and kiosk mode.

Verifying Your Setup

After completing setup, confirm the following in HqO Admin:

  • Navigate to Resource Booking and check that your Tripleseat resources appear in the resource list with a green Tripleseat badge.

  • Go to the Calendar tab and confirm that the calendar view is disabled for Tripleseat resources — this is expected behavior.

End User Experience

  1. The tenant opens the HqO app or web experience and navigates to a Tripleseat resource.

  2. They can view the availability calendar showing available and blocked time slots.

  3. They click Book, and the Tripleseat lead form appears within the HqO experience.

  4. They fill out and submit the form. A confirmation message (configured in Tripleseat) is displayed on screen.

Things to Know

  • Admin booking is not available for Tripleseat resources. Admins cannot book on behalf of users — all bookings must be made by tenants via the lead form.

  • Tripleseat resources are read-only on the Kiosk. Tenants can view availability on a kiosk display, but they must book through the web or app.

  • Availability reflects Tripleseat in real time. However, a time slot will only be blocked off in HqO once a lead has been converted to an event in Tripleseat. Submitting a lead form alone will not block the time. Because of this, it is possible for multiple tenants to submit leads for the same time slot before it becomes blocked. It's worth setting expectations with tenants about this.

  • Tenants can request times outside of displayed availability. You can configure availability windows to control what times are shown in the HqO calendar, but because booking is completed via a Tripleseat lead form, tenants are able to request times that fall outside of those windows. Keep this in mind when setting availability and managing incoming leads.