Share a Calendar URL with Guest Question Answers Pre-filled

You can share a calendar with guests after pre-filling answers to the questions they would otherwise complete during scheduling.

Availability

This feature is available on all plans.

Configure question prefill

Add parameters to the calendar URL to share it with guest question answers pre-filled by the host.

For details about using parameters to identify the traffic source or associate member ID information, see Add Traffic Source, Member ID, or Other Information to a Calendar URL.

The URL parameters for the four default questions are:

guest_company: Company
guest_name: Guest name
guest_email: Guest email
guest_comment: Guest comment

Important notes

You can pass up to 25 parameters. The four default Guest questions do not count toward this limit.
If you pass 26 or more parameters, the scheduling page displays the error message “422 Unprocessable Entity: The number of custom URL parameters exceeds the limit.”
Even with 25 or fewer parameters, an error may appear if the URL is too long.
If a parameter value contains reserved query-string characters such as &, ?, #, =, or spaces, percent-encode the value in advance using the equivalent of encodeURIComponent.

Example using default questions

To pre-fill the guest name and email address, use a URL in the following format:

<scheduling page URL>?guest_name=佐藤太郎&guest_email=example%40co.jp

When a guest opens the URL, the Name and Email fields on the information entry screen are automatically filled with these values.

Pre-fill custom Guest questions

You can also pre-fill questions added under Guest questions.

Note: File upload questions cannot be pre-filled.

Text
Parameter: <custom_form_field_id>=<text>
Percent-encoding the text is recommended.
Example: 12345=Hello
Multi-line text
Parameter: <custom_form_field_id>=<text>
Percent-encoding the text is recommended.
Example: 12345=Hello%0AWorld
Checkbox
Parameter: <custom_form_field_id>=<displayed answer value>
Separate multiple answer values with commas.
Example: 12345=X,Y,Z
Radio button
Parameter: <custom_form_field_id>=<displayed answer value>
Only one answer can be selected.
Example: 12345=X
Select menu
Parameter: <custom_form_field_id>=<displayed answer value>
Only one answer can be selected.
Example: 12345=X
Date
Parameter: <custom_form_field_id>=<yyyy-mm-dd>
Only the yyyy-mm-dd format is accepted.
Example: 12345=2000-01-01
Number
Parameter: <custom_form_field_id>=<half-width digits>
Full-width digits, hyphens, and other characters cause an error.
Example: 12345=111111

You can find the custom_form_field_id on the question edit screen.

Example using a custom question

To pre-fill the guest name, email address, and a custom radio-button question, use a URL in the following format:

<scheduling page URL>?guest_name=山田太郎&guest_email=test%40com&<custom_form_field_id>=同意する

When a guest opens the URL, the Name, Email, and radio-button question on the information entry screen are automatically filled.

In the example calendar, the radio-button question asks the guest to read the terms and select one of the displayed answer values: Agree or Disagree.

Pre-fill questions in a calendar widget

You can also pre-fill questions when using a widget.

For details, see Calendar Widget | TimeRex Developer Portal.