These docs are for v1.0.0. Click to read the latest docs for v2.0.0.

Redirecting booking confirmation data

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:

  1. Turn Automatic redirect to ON.
  2. Enter the URL of your redirect page.
  3. Click the checkbox to Send booking confirmation data to redirect page.
  4. Click Save to apply these settings to your Booking page.
2216

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&note=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:

  1. Booking form submission data
  2. 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 nameDescription
NameThe name provided by the Customer in the Booking form.
EmailThe email provided by the Customer in the Booking form.
companyThe company provided by the Customer in the Booking form.
mobileThe mobile phone number provided by the Customer in the Booking form.
phoneThe phone number provided by the Customer in the Booking form.
noteThe note provided by the Customer in the Booking form.
customerGuestsList of additional attendees (emails) invited by the Customer.
locationThe 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):

686

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 nameDescription
bookingPageThe Customer-facing name of the Booking page used to make the booking.
subjectThe name of the Service or Subject as defined in the Booking form.
creationTimeThe date and time when the booking was created, in UTC.
meetingTimeThe starting date and time, in the Booking page time zone.
timeZoneThe time zone of the Booking page as defined in the Availability section.
utcOffsetThe 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.