Send data to your redirect page using URL parameters
OnceHub allows you to send booking confirmation data to the redirect page via URL parameters. Every time a booking is successfully scheduled on your Booking page, the Booking form submission data and information about the booking that was scheduled will be converted into key-value pairs (KVPs) and appended to the redirect URL.
This feature can be used to create a custom confirmation page, enable client-side integrations, or enrich Customer data profiles, among other applications. Learn more about use cases for redirecting booking confirmation data
Set up Automatic redirect with booking confirmation data
In order to send booking confirmation data to your redirect page, you must enable the Automatic redirect feature from the Booking form and redirect section of your Event type or Booking page:
- Turn Automatic redirect to ON.
- Enter the URL of your redirect page.
- Click the checkbox to Send booking confirmation data to redirect page.
- Click Save to apply these settings to your Booking page.
Figure 1: Automatic redirect settings - Custom confirmation page
That’s it!
You have enabled redirecting booking confirmation data to your specified page via URL parameters.
Example URL with booking confirmation data
The following is an example of a URL containing booking confirmation data that is sent to the redirect page:
http://www.example.com/?Name=John%20Smith&[email protected]&subject=Example%20Subject&company=Example%20Company&phone=1-2025550195¬e=I%20look%20forward%20to%20the%20meeting.&bookingPage=financial&creationTime=2018-04-25T05:08:18.843Z&meetingTime=2018-04-25T10:45:00.000Z&timeZone=Eastern%20time&utcOffset=-5
Booking confirmation data sent via URL parameters
Two types of booking confirmation data will be sent to your redirect page via URL parameters:
- Booking form submission data
- Booking data created when scheduling
Booking form submission data
Customer information submitted to the Booking form will be added as URL parameters and sent to the custom confirmation page URL upon redirect. Any Booking form field (including Custom fields) for which the Customer has submitted data will be added to the redirect URL. Empty Booking form fields will not be added to the redirect URL.
The following table contains the parameter name and description of the fields sent:
| Parameter name | Description |
|---|---|
Name | The name provided by the Customer in the Booking form. |
Email | The email provided by the Customer in the Booking form. |
company | The company provided by the Customer in the Booking form. |
mobile | The mobile phone number provided by the Customer in the Booking form. |
phone | The phone number provided by the Customer in the Booking form. |
note | The note provided by the Customer in the Booking form. |
customerGuests | List of additional attendees (emails) invited by the Customer. |
location | The location of the meeting. |
<custom field name> | The name of the User-defined Custom field. |
How are Custom fields handled?
Custom fields for which the Customer enters Booking submission data will be added to the URL when booking confirmation data is sent to the redirect page. The Custom field parameter name is the Field name as defined by the User (with spaces removed):
Figure 2: Booking form editor - Defining the field name for a Custom field
Learn more about creating and editing Custom fields.
Booking data created when scheduling
Booking data that is created when a new booking is scheduled will be added as URL parameters and sent to the redirect page.
The following table contains the parameter name and description of the fields sent:
| Parameter name | Description |
|---|---|
bookingPage | The Customer-facing name of the Booking page used to make the booking. |
subject | The name of the Service or Subject as defined in the Booking form. |
creationTime | The date and time when the booking was created, in UTC. |
meetingTime | The starting date and time, in the Booking page time zone. |
timeZone | The time zone of the Booking page as defined in the Availability section. |
utcOffset | The UTC offset of the Booking page time zone, in integer. |
Constraints
The following constraints are important to keep in mind when redirecting booking confirmation data:
- Booking confirmation data will only be sent to the redirect page when a booking is scheduled (not canceled, rescheduled, or reassigned).
- OnceHub does not impose length limits for fields passed in the redirect URL. If the length of the query string exceeds the URL character limit, the URL will be truncated and some data may not be sent.
- Booking confirmation data will not be sent to the redirect page if you are using a CRM record ID to skip or prepopulate the booking form, because this data is encrypted.
Updated about a year ago