Using Salesforce Record IDs to personalize scheduling on landing pages

You can use Salesforce Record IDs to personalize the booking process on your landing pages. Recognizing the Customer by their record ID provides two key benefits:

In this article, you'll learn how to pass the Salesforce Record ID to your landing pages. Then, you'll learn how to generate the personalized website embed or button code for your landing pages.

Note If the Customer is not recognized based on the Salesforce Record ID, OnceHub will use the Customer's email address to check if the record already exists in your CRM. Learn more about integrating with Salesforce


To use Salesforce Record IDs with your landing pages, you must:

NoteFor security and privacy reasons, using CRM record IDs to skip or pre-populate the Booking form is not compatible with collecting data from an embedded Booking page or redirecting booking confirmation data.

OnceHub parameters for Salesforce

To recognize the Customer by the Salesforce Record ID, you need to pass the OnceHub parameters for Salesforce to your landing page:

  • Lead Record ID: sosfleadid
  • Contact Record ID: sosfcontactid
  • Case Record ID: sosfCaseId

You can also add an additional variable to your landing page to skip the Booking form step:

  • Hiding the Booking form: soSkip=1

ImportantWhen working with Salesforce Person Accounts, you will need to pass the related Contact Record ID and ensure that the Person Account includes a Contact ID lookup field.

Step 1: Constructing the landing page's URL parameters

There are different operators used in the syntax of your URL:

  • ? - You must add the question mark to separate your URL from the variables.
  • & - You can pass multiple variables by separating the variables with the ampersand
  • - The equal sign separates the variable from the value assigned to that variable.

Take the following example landing page link:

If you wanted to pass a Salesforce Lead Record ID with a value which is E9888900, you can add the following to the webpage link:

If you wanted to pass the variable to skip the Booking form step as well, you could add the skip variable to the link:

Step 2: Generate the personalized code for your landing pages

Now that you have passed the Salesforce Record Id to your landing page, you need to ensure that you have placed the personalized website embed or button code on your landing page. 

  1. In OnceHub, go to Share & Publish.
  2. Select the Website embed tab or Website button tab. 
  3. Select Customer data is passed using the Salesforce record ID (web form integration) from the Customer data step.
  4. Copy and paste the relevant code in your landing page.

ImportantIf the Website embed or button code placed on your webpage was added prior to November 7, 2015, you will need to replace it with the updated OnceHub code.

Was this article helpful?
Thank you for your feedback!