Maximizing Upsells: Automating Free Vehicle Class Upgrades with HQ’s API
Free upgrades delight renters and unlock bigger baskets. By automating free vehicle class upgrades with HQ’s API, you can turn availability into loyalty—while protecting margins and simplifying operations. In this guide, you’ll learn how to design a rules-based upgrade flow using HQ Rental Software’s API capabilities, from discovering upgradeable classes to applying the upgrade, notifying the customer, and keeping reservations in sync.
Why free upgrades drive revenue and retention
A free vehicle class upgrade is a powerful lever:
- It converts standard bookings into memorable experiences.
- It moves inventory strategically without manual juggling.
- It opens the door to paid add‑ons and future bookings.
When you automate this in your tech stack, you scale the benefit: consistent execution, fewer handoffs, and a better experience across online reservations and front‑desk operations.
What you can do with HQ’s API today
HQ Rental Software provides API capabilities that enable an end‑to‑end upgrade workflow:
- List available vehicle classes for free upgrade
- Apply free vehicle class upgrade
- Returns the available cars for a given location and reservation date range
- Reservations: update statuses (Open, Cancel, Pending, Quote, No Show), and mark reservation as ready for pickup
- Emails: trigger templates, send reservation confirmation email by id, and send reservation contract email by id
- Webhooks: Register a webhook to automate event‑driven actions
- Filters: get examples of allowed filters to structure your queries
- Assign vehicle / Detach vehicle to manage inventory control
- Blocked Periods: create, update, and delete blocked periods to avoid conflicts
- Updates the vehicle class of a reservation (Only Existing Bookings) for precise control when adjustments are needed
- Upload primary driver signature to support a paperless, digital workflow
Beyond the API, HQ also supports your commercial engine with solutions like Online Reservations & Payments, Fleet Management, Self‑service Car Rental, and Telematics, plus 30+ integrations (including Stripe, Global Payments, QuickBooks, E‑ZPass, and Xero). These ecosystem capabilities help you operationalize upgrades across channels and teams.
Upgrade automation at a glance
Use this quick map to align your business objective with the relevant capability:
| Objective | Relevant HQ API capability |
|---|---|
| Identify candidates for upgrades | Returns the available cars for a given location and reservation date range; List available vehicle classes for free upgrade |
| Apply the chosen upgrade | Apply free vehicle class upgrade |
| Keep reservation details accurate | Updates the vehicle class of a reservation (Only Existing Bookings); Updates a reservation; Assign/Detach vehicle |
| Notify the customer | Trigger an email template; Send reservation confirmation email by id; Send reservation contract email by id |
| Automate timing and triggers | Register a webhook; use Filters to shape API queries |
| Prevent scheduling conflicts | Blocked Periods endpoints; Returns available cars for location/date range |
Step‑by‑step: A rules‑based free upgrade flow
1) Authenticate once, call safely throughout
- Generate your Tenant Token (Settings > Integrations > Api Token) and a User Token (Settings > Users > Generate new token), then create a Base64 string of
tenant_token:user_token. - Send it on each request header:
Authorization: Basic {AUTHENTICATION_TOKEN}
Content-Type: application/json
2) Trigger on the moments that matter
- Register a webhook to listen for reservation events (e.g., new reservation, date change). This is your automation entry point.
3) Confirm availability and context
- Use the endpoint that returns the available cars for a given location and reservation date range to understand capacity before offering an upgrade.
4) Discover upgrade options
- Call List available vehicle classes for free upgrade to get the eligible classes your system can offer at no extra cost.
5) Apply the upgrade
- If your business rules match (e.g., premium class has spare capacity, VIP customer, seasonality window), use Apply free vehicle class upgrade to set the new class on the reservation.
- If you need to refine the reservation further, use Updates the vehicle class of a reservation (Only Existing Bookings) or Updates a reservation.
6) Keep inventory and assignments clean
- Assign vehicle or Detach vehicle as needed, and leverage Blocked Periods to prevent double bookings.
7) Communicate instantly
- Send a confirmation using Trigger an email template, Send reservation confirmation email by id, or Send reservation contract email by id. Clear communication increases perceived value and reduces counter questions.
8) Prepare a paperless pickup
- Upload primary driver signature to streamline arrival. You can also mark reservation as ready for pickup to make your front‑desk handoff seamless.
9) Price other add‑ons confidently
- If you present paid extras alongside the free upgrade, HQ’s API can return a list of applicable additional charges and return the price for a selected configuration (dates, brand, vehicle class). This helps you quote transparently without manual math.
Authorization and regional base URLs
Your base URL depends on where your system is hosted. Use the region provided by HQ when you request API access:
- America: https://api.caagcrm.com/api/
- America 3: https://api-america-3.caagcrm.com/api-america-3/
- America West: https://api-america-west.caagcrm.com/api-america-west/
- America Miami: https://api-america-miami.caagcrm.com/api-america-miami/
- Europe: https://api-europe.caagcrm.com/api-europe/
- Asia: https://api-asia.caagcrm.com/api-asia/
Authentication header pattern:
- Combine
tenant_token:user_token - Base64‑encode the result
- Send
Authorization: Basic {AUTHENTICATION_TOKEN}on each call
Tip: Rotate user tokens periodically and scope access by user to align with least‑privilege principles.
Designing smart upgrade rules (without guesswork)
Use widely accepted upgrade heuristics to balance guest delight with control:
- Capacity‑led: Offer a free upgrade if the target class has healthy availability for the reservation window.
- Customer‑led: Prioritize members, repeat renters, or high‑value segments during peak periods.
- Timing‑led: Trigger checks right after booking, at T‑48 hours, and during pre‑arrival—so inventory insights are fresh when you decide.
- Location‑led: Only offer upgrades at locations with adequate supply or when relocations are already planned.
- Protection‑led: Exclude blocked vehicles and honor Blocked Periods. If a vehicle is assigned, confirm with Assign/Detach vehicle logic before changing class.
Pair these rules with HQ’s Filters and Webhooks so you minimize API calls, reduce race conditions, and keep operations deterministic.
Preventing friction at the counter
A free upgrade should smooth the pickup—not complicate it. Use these API‑enabled steps:
- Mark reservation as ready for pickup once the class is confirmed.
- Send the updated contract with Send reservation contract email by id so customers see the upgraded class in writing.
- Capture the primary driver signature digitally to stay paperless.
With HQ’s Mobile Access and Go Paperless capabilities, your staff can document condition photos and signatures in the field, keeping documentation airtight.
Reporting and continuous improvement
Leverage HQ’s Advanced Reporting to keep an eye on key performance indicators. Track how often upgrades are applied, which locations use them most, and how they correlate with add‑on uptake and satisfaction signals. Export data as needed and refine your rules accordingly.
You can also shape seasonality with Seasons to reflect your business calendar and adjust upgrade appetite by period.
Frequently asked questions
How do I ensure a free upgrade won’t cause overbooking?
Use the endpoint that returns the available cars for a given location and reservation date range, and respect Blocked Periods. If a vehicle is already assigned, reconcile via Assign vehicle or Detach vehicle before changing classes.
Can I reverse an upgrade if conditions change?
Yes. You can update the vehicle class of a reservation (Only Existing Bookings) or update a reservation to revert or adjust after the fact.
How do I price add‑ons alongside a free upgrade?
Call the endpoints that return a list of applicable additional charges and return the price for the selected dates, brand, and vehicle class. Present those totals in your confirmation email.
How do I notify customers automatically?
Use Trigger an email template, Send reservation confirmation email by id, or Send reservation contract email by id to deliver timely updates.
Can I scope upgrades by location or season?
Yes. Use location in your availability queries and model seasonality with Seasons. Your business rules can choose when and where to offer upgrades.
How do I integrate in‑store payments with this flow?
If you accept in‑person payments, you can return a connection token for stripe terminal. This helps align your counter experience with the reservation that just changed.
Practical takeaways
- Build your upgrade flow around: availability check → eligible classes → apply upgrade → update reservation → notify customer.
- Use Webhooks to trigger the flow automatically on reservation creation or change.
- Protect operations with Blocked Periods and assignment checks before switching classes.
- Keep communications tight with email endpoints so customers see the benefit immediately.
- Use pricing endpoints for transparent add‑on quotes during or after the upgrade.
- Monitor results in Advanced Reporting and fine‑tune your rules by location and season.
Related topics to explore next
- Online Reservations & Payments
- Fleet Management
- Self‑service Car Rental
- Telematics
- Integrations
- API Documentation and Knowledge Base
Conclusion
Automating free vehicle class upgrades with HQ’s API lets you delight customers, move inventory intelligently, and set up consistent upsell moments—without adding manual workload. With event‑driven automation, clean authorization, and reservation‑safe controls, you can scale a signature experience across every location.
Ready to turn upgrades into a growth engine? Start your free 7‑day trial of HQ Rental Software—no credit card required—and put this workflow into action today.