Pre-populate contact info in the scheduling widget

Created by Julien Pauthier, Modified on Mon, 5 Jun, 2023 at 10:10 AM by Julien Pauthier

How to prefill data into your scheduling widget form

When sending an emailing including a scheduling link for instance, you might want to spare your clients from filling in their personal data in the scheduling form. 


You can pre-populate the contact info (first name, last name, email, phone) in the URL to your scheduling widget. Here's how to do it.


Add GET parameters to your scheduling URL

The URL of your minisite is like https://app.agendize.com/book/XXXXXX. If you use an iframe integration, the URL of the widget is like https://app.agendize.com/book/iframe/XXXXXX (Where XXXXXX is the company ID).


In this URL, you can add GET parameters to prepopulate the contact form that appears at the end of the scheduling process. The name of these parameters are the following: 

  • First name: firstname
  • Last name: lastname
  • Email: email
  • Phone: phone

To add parameters to the URL, add the character '?' at the end of the URL (except if there is already a '?' with other parameters, like "lang" for example) and then add <name of parameter>=<value> for every parameter, separated by the character '&'. 


Custom fields

You can also populate custom widget fields or CRM fields, by adding their ID the same way in the URL. You can obtain the ID of a field by click on it in the widget field editor:


Note: You can also define an external ID (externalId) and refer to it: ...&company=MyCompany



Examples

Here are two examples: 

  • app.agendize.com/book/iframe/XXXXXX?firstname=John&lastname=Smith&phone=13334445678&email=johnsmith@agendizedemo.com
  • app.agendize.com/book/XXXXX?lang=en&firstname=Mary&lastname=Jones&phone=122233345678&email=maryjones@agendizedemo.com


Clicking on such link, the user will go through the scheduling process and reach the contact info step: after checking all prefill data, he/she will simply have to confirm the scheduling form.


Important note about data privacy

If you use a Google Analytics tracker, lease make sure that you do exclude these 4 GET parameters from the tracking, so that no personal data is collected to GA in the process: phone,email,firstname,lastname


Please refer to this documentation for more details: https://support.google.com/analytics/answer/1010249?hl=en


Important note about the ability to encrypt appointment scheduling URLs


The Agendize platform allows you to encrypt URLs in order to secure any personal data (last name, first name, email address, etc.): https://developers.agendize.com/v2.3/scheduling/reference/cipher/index.jsp

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article