If your business uses a third-party platform such as a CRM, POS system, or other internal tool, you can streamline the process of creating customer bookings in Waitwhile by utilizing query parameters. This method allows staff to pre-fill booking information via a customized URL, reducing manual data entry and improving operational efficiency.
What are query parameters?
Query parameters are values appended to the end of a URL that allow you to pass information into Waitwhile’s platform (booking or waitlist registration form). When a staff member accesses a link containing query parameters, the Waitwhile booking page will open with specific fields already filled in.
How to use query parameters in the Staff Experience
In the Staff Experience, query parameters can be utilized to efficiently create both bookings and waitlist visits without requiring staff to manually input customer details.
By constructing a prefilled URL that includes parameters such as name, phone, email, and service, staff can quickly initiate a new booking by opening the booking page with those fields already completed—and optionally, auto-submit the form using autosubmit=true.
Similarly, for waitlist visits, staff can use query parameters on the waitlist page to pre-populate visitor information and join them to the queue instantly.
This is particularly useful when integrating Waitwhile with internal systems or workflows, allowing staff to launch booking or waitlist flows directly from another platform while maintaining a seamless and accurate customer experience.
Example Staff Booking Experience URL
https://new.waitwhile.com/calendar?action=add-visit&state=BOOKED&locationShortName=firstprioritymedical&service=ngxV6j4EGk1uqkfu2C9v&resource=D86FM1l2nTinzzu3E2hW&firstName=Mark&lastName=Jones&phone=4043535523&ORZU8sIgka4FqVtoy41w=yes&date=2025-05-12T09:30
In this example:
calendar→ Opens the calendar page in the staff experienceaction=add-visit&state=BOOKED→ Pre-fills the visit statefirstName=Mark→ Pre-fills the customer’s first name.lastName=Jones→ Pre-fills the customer’s last name.phone=4043535523→ Pre-fills phone number.service=ngxV6j4EGk1uqkfu2C9v→ Pre-fills Service IDresource=D86FM1l2nTinzzu3E2hW→ Pre-fills the resource IDORZU8sIgka4FqVtoy41w=yes→ Pre-fills the custom data field ID & answerdate=2025-05-12T09:30→ Pre-fills the booking date and time
This URL performs the following actions:
Opens the Waitwhile booking page for the specified location.
Pre-fills the name, phone number, email address, and party size.
Example Staff Waitlist Experience URL
https://new.waitwhile.com/?action=add-visit&state=WAITING&locationShortName=revival&service=MvweDwLofCKof0tTgUtZ&r&name=Julia%20Wilson&phone=4043239182&partySize=1
Supported query parameters in staff experience
Field | Query Parameter | Example |
Name |
|
|
Phone |
|
|
|
| |
Party Size |
|
|
Service |
| ServiceID (e.g. |
Resource |
| ResourceID (e.g. |
Tags |
|
|
Customer ID |
|
|
Custom Fields | Custom Data field ID (e.g. |
|
Date & Time |
|
|
Note: Custom fields must use the data field ID defined in your Waitwhile settings.
How to construct a Booking or Visit URL
To create a working URL that pre-fills booking details in Waitwhile:
Obtain your booking or visit page URL
Bookings:https://new.waitwhile.com/calendar?action=add-visit&state=BOOKED&locationShortName={input}
Waitlist Visit:https://new.waitwhile.com/?action=add-visit&state=WAITING&locationShortName={input}Append the appropriate query parameters
Example:&name=Sarah+Lee&email=sarah@example.comVerify the URL in a browser
Confirm that the correct fields are being populated.
Security & Privacy considerations: Avoid including sensitive personal information in URLs if the links are shared or stored in insecure environments
Have additional questions or need assistance? Reach out to us via chat or at support@waitwhile.com