Booking Calendar URL Parameters: Syntax and Processing Rules
Personalize the scheduling experience for your guests and maximize booking efficiency by using custom URL parameters. URL parameters can prefill Booking Form questions and configure additional booking link behaviors, such as skipping the Booking Form step during scheduling.
URL Parameter Categories
Section titled “URL Parameter Categories”URL parameters for Booking Calendars are grouped into three main categories:
- Contact Properties: Identify an existing OnceHub Contact with
c_id, or prefill the booking form with external URL parameters that pass data from an outside source, such as a CRM or web form. You can also control whether guests see or skip the booking form. - Meeting Configuration Parameters: Dynamically adjust meeting settings, such as locking the host, adding co-hosts, setting the default guest time zone, or locking meeting durations.
- Tracking Parameters: Capture UTM tags and hidden field data for tracking and reporting without altering meeting configurations or guest form fields.
How to Add URL Parameters to Your Booking Links
Section titled “How to Add URL Parameters to Your Booking Links”Follow the steps below to add URL parameters to your Booking links:
- Start with your base Booking link:
https://oncehub.com/example - Add a query separator (
?) at the end of the Booking link:https://oncehub.com/example? - Add your first parameter after the query separator:
https://oncehub.com/example?name=XXXX - If adding multiple parameters, separate each parameter with an ampersand (
&):https://oncehub.com/example?name=XXXX&email=XXXX
URL Parameters Processing Rules
Section titled “URL Parameters Processing Rules”The following processing rules apply to all URL parameters:
- Space encoding: Encode all spaces within parameter values as
%20. For example, for John Doe, usename=John%20Doe. - Parameter key casing: Parameter keys are not case-sensitive. For example,
Name=Johnis treated the same asname=John. - Parameter value casing: Parameter values are case-sensitive. For example,
Johnis treated as a different value fromjohn.
Combining Parameters
Section titled “Combining Parameters”You can combine parameters from different categories in the same link.
Combining c_id with external URL parameters lets you associate the booking with an existing Contact in OnceHub while also passing live prefill values, meeting configurations, or tracking data through the URL.
For example, this link identifies an existing Contact, passes the guest’s company from an external source, sets the meeting duration, and records the traffic source:
https://oncehub.com/example?c_id=CTC-xxxxxxxxxxxxxx&company=Acme%20Corp&duration_minutes=15&utm_source=newsletter
c_idandcompany: Contact Properties and Booking Form fieldsduration_minutes: Meeting Configurationutm_source: Tracking
