---
title: "Salesforce record creation, update, and assignment rules"
description: "The Salesforce setup process includes 5 steps: API connection, Installation, Field validation, Field mapping, and Creation rules."
url: "https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/salesforce-record-creation-update-and-assignment-rules"
---

The Salesforce setup process includes 5 steps: [API connection](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/connecting-salesforce-api-user "How to connect a Salesforce API User"), [Installation](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/installing-oncehub-connector-for-salesforce "How to install the ScheduleOnce connector for Salesforce"), [Field validation](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/handling-required-salesforce-fields-in-field-validation-step "Handling required Salesforce fields in the Field validation step"), [Field mapping](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/mapping-oncehub-fields-to-non-mandatory-salesforce-fields "Mapping ScheduleOnce fields to non-mandatory Salesforce fields"), and Creation rules.

In this article, you’ll learn about how to define the way Leads, Contacts, and Cases will be created, updated, and assigned in Salesforce when a booking is made.

## Requirements

[Section titled “Requirements”](#requirements)

To set up the OnceHub connector for Salesforce, you must:

* Be a [OnceHub Administrator](https://help.staticso2.com/account-administration/user-management/user-roles-overview "Differences between Administrator and Member").
* Have an [active connection to your Salesforce API user](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/connecting-salesforce-api-user "How to connect a Salesforce API User").

You do not need an assigned product license to install and update Salesforce account settings. [Learn more](https://help.staticso2.com/account-administration/user-management/user-management-and-seats)

## Accessing the Salesforce connector setup page

[Section titled “Accessing the Salesforce connector setup page”](#accessing-the-salesforce-connector-setup-page)

1. Click the gear icon located in the top-right corner of the page.
2. Select **Account Integrations** from the dropdown menu.
3. Filter for **CRM**.
4. Click on the **Salesforce (For Booking Pages)** tile.
5. Click the **Setup** button in the Salesforce box (Figure 1).

![](https://help.staticso2.com/_astro/1568296450680.CI9hH93k_Z15palB.png)Figure 1: Salesforce setup

On the **Salesforce connector setup** page, select **Creation rules** (Figure 2).

![](https://help.staticso2.com/_astro/1568296576877.HbYUPiT0_ZWWjz7.png)Figure 2: Creation rules

## Lead records ![](https://help.staticso2.com/_astro/1568296995106.DlHewkol_ZOznUo.png)Figure 3: Lead records

[Section titled “Lead records Figure 3: Lead records”](#lead-records-figure-3-lead-records)

### Existing Leads

[Section titled “Existing Leads”](#existing-leads)

In this case, the Customer making the booking exists in Salesforce and is recognized based on their Lead Record ID or their email address.

* If you’re scheduling with existing Salesforce Leads only, you should use our [Personalized links (Salesforce ID)](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/using-personalized-links-salesforce-id "Using Personalized links (Salesforce ID)") in your [Salesforce email templates ](https://help.salesforce.com/articleView?id=email_create_a_template.htm\&type=5)and [Salesforce emails](https://help.salesforce.com/articleView?id=send_email_directly_from_crm_record.htm\&type=5) to automatically recognize the Lead based on their Salesforce Lead record ID. This allows you to [prepopulate the Booking form step with Salesforce data, or skip it altogether](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/prepopulate-or-skip-booking-form-step-in-salesforce-integration "Prepopulating or skipping the Booking form step in Salesforce integration").
* If you’re not sure that the Customer making the booking already exists in Salesforce, you should use the [General links](https://help.staticso2.com/scheduleonce/sharing-publishing/general-one-time-links/using-general-links "Using General links") to recognize the Customer based on their email address. When the Lead or Contact record is identified, it will be updated based on the option you have chosen in the Record creation and update rules.

When a booking is made, the options provided allow you to choose between:

* Overriding the existing Salesforce data with OnceHub data.
* Keeping the existing Salesforce data and only update empty fields.

You can also decide whether to keep the Salesforce ownership, assign the record to the OnceHub Booking page owner, or assign the record using [Salesforce active assignment rules](https://help.salesforce.com/articleView?id=creating_assignment_rules.htm\&type=5).

### New Leads

[Section titled “New Leads”](#new-leads)

In this case, the Customer making the booking does not exist in Salesforce. For this reason, you should use [General links](https://help.staticso2.com/scheduleonce/sharing-publishing/general-one-time-links/using-general-links "Using General links") when making bookings with prospects that may or may not exist in your Salesforce database.

When a booking is made, OnceHub creates a new Lead record in Salesforce and adds a new Salesforce Activity Event. You can decide whether to assign the Lead record to the OnceHub Booking page Owner or assign the Lead record using [Salesforce active assignment rules](https://help.salesforce.com/HTViewHelpDoc?id=creating_assignment_rules.htm\&language=en_US).

## Contact records

[Section titled “Contact records”](#contact-records)

![](https://help.staticso2.com/_astro/1568297092540.DtbUFSeB_BypCC.png)Figure 4: Contact records

### Existing Contacts

[Section titled “Existing Contacts”](#existing-contacts)

In this case, the Customer making the booking exists in Salesforce and is recognized based on the email address or Contact Record ID.

* If you’re scheduling with existing Salesforce Contacts only, you should use our [Personalized links (Salesforce ID)](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/using-personalized-links-salesforce-id "Using Personalized links (Salesforce ID)") in your [Salesforce email templates ](https://help.salesforce.com/articleView?id=email_create_a_template.htm\&type=5)and [Salesforce emails](https://help.salesforce.com/articleView?id=send_email_directly_from_crm_record.htm\&type=5) to automatically recognize the Contact based on their Salesforce Contact record ID. This allows you to [prepopulate the Booking form step with Salesforce data, or skip it altogether](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/prepopulate-or-skip-booking-form-step-in-salesforce-integration "Prepopulating or skipping the Booking form step in Salesforce integration").
* If you’re not sure that the Customer making the booking already exists in Salesforce, you should use the [General links](https://help.staticso2.com/scheduleonce/sharing-publishing/general-one-time-links/using-general-links "Using General links") to recognize the Customer based on their email address. When the Lead or Contact record is identified, it will be updated based on the option you have chosen in the Record creation and update step.

When a booking is made, the options provided allow you to choose between:

* Overriding the existing Salesforce data with OnceHub data.
* Keeping the existing Salesforce data and only update empty fields.

You can also decide whether to keep the Salesforce ownership or assign the record to the OnceHub Booking page owner.

### New Contacts

[Section titled “New Contacts”](#new-contacts)

In this case, the Customer making the booking does not exist in Salesforce and the Account may or may not exist in Salesforce. For this reason, you should use [General links](https://help.staticso2.com/scheduleonce/sharing-publishing/general-one-time-links/using-general-links "Using General links") when making bookings with prospects that may or may not exist in your Salesforce database.

When a booking is made, OnceHub creates a new Contact record in Salesforce, assigns the Contact to the OnceHub Booking page Owner, and adds a new Salesforce Activity Event.

Note

When an Account does not exist in Salesforce, it is always created based on OnceHub data.

## Case records

[Section titled “Case records”](#case-records)

![](https://help.staticso2.com/_astro/1568297552109.D74qCbAh_Z2nnar5.png)Figure 5: Case records

### Existing Cases

[Section titled “Existing Cases”](#existing-cases)

In this case, the Case exists in Salesforce and is recognized based on the Salesforce Case Record ID. You should use our [Personalized links (Salesforce ID)](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/using-personalized-links-salesforce-id "Using Personalized links (Salesforce ID)") in your [Salesforce email templates ](https://help.salesforce.com/articleView?id=email_create_a_template.htm\&type=5)and [Salesforce emails](https://help.salesforce.com/articleView?id=send_email_directly_from_crm_record.htm\&type=5) to automatically recognize the Case based on the Salesforce Case Record ID. This allows you to [prepopulate the booking form step with Salesforce data, or skip it altogether](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/prepopulate-or-skip-booking-form-step-in-salesforce-integration "Prepopulating or skipping the Booking form step in Salesforce integration").

When a booking is made, the options provided allow you to choose between:

* Overriding the existing Salesforce data with OnceHub data.
* Keeping the existing Salesforce data and only update empty fields.

You can also decide whether to keep the Salesforce ownership, assign the record to the OnceHub Booking page owner, or assign the record using [Salesforce active assignment rules](https://help.salesforce.com/articleView?id=creating_assignment_rules.htm\&type=5).

Note

The Contact is always updated based on the Record creation and update rules.

### New Cases

[Section titled “New Cases”](#new-cases)

In this case, the Case doesn’t exist in Salesforce and the Customer making the booking may or may not exist in Salesforce. For this reason, you should use [General links](https://help.staticso2.com/scheduleonce/sharing-publishing/general-one-time-links/using-general-links "Using General links") when making bookings with prospects that may or may not exist in your Salesforce database.

When a booking is made, OnceHub creates a new Case record in Salesforce and adds a new Salesforce Event upon booking. You can decide whether to assign the Case record to the OnceHub Booking page Owner or assign the Case record using Salesforce active assignment rules.

Note

The Contact is always updated based on the Record creation and update rules.