---
title: "Salesforce connector issues"
description: "This article describes potential issues with the Salesforce integration and how these issues can be fixed."
url: "https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/salesforce-connector-issues"
---

This article describes potential issues with the[ Salesforce integration](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/salesforce-integration "The ScheduleOnce connector for Salesforce") and how these issues can be fixed. If you’re still having problems, please [contact us](https://help.staticso2.com/contact-us/) and we will be happy to assist you.

If Users connected to Salesforce cannot accept bookings, there could be a number of different causes for this. To identify the root cause, you need to determine whether the issue affects all Users connected to Salesforce, or if it affects individual Users only.

## Issues affecting all Users connected to Salesforce

[Section titled “Issues affecting all Users connected to Salesforce”](#issues-affecting-all-users-connected-to-salesforce)

In this case, you should first check errors related to the [Salesforce API User](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/connecting-salesforce-api-user "How to connect a Salesforce API User"). Then, you should check the status of the Salesforce API call usage in your Salesforce account.

### Checking the Salesforce API User

[Section titled “Checking the Salesforce API User”](#checking-the-salesforce-api-user)

**The Salesforce API User connection in your OnceHub account**

If we have detected a problem with the API User connection, the API User will be disconnected from your OnceHub account. In this case, you must reconnect the Salesforce API User.

This typically happens for the following reasons:

* The API User credentials are no longer valid. The [Salesforce password](https://help.salesforce.com/articleView?id=security_overview_passwords.htm\&type=5) may have been reset and the [security token](https://help.salesforce.com/articleView?id=user_security_token.htm\&type=5) may have changed. OnceHub uses these credentials to validate the API User connection, so they must be up to date.
* The OnceHub connector for Salesforce managed package was uninstalled and then reinstalled in your Salesforce organization. When this occurs, the Salesforce API token expires.

To resolve this issue, follow the steps below:

1. Hover over the lefthand menu and go to the Booking pages icon → open the lefthand sidebar, then select **Integrations →&#x20;****CRM**. In the **Salesforce** box, click **Setup** (Figure 1). ![](https://help.staticso2.com/_astro/salesforce-api-connection-error.To8deNwr_11M4D9.png)Figure 1: Salesforce API User Disconnected
2. Click the **Reconnect the API User** button (Figure 2). ![](https://help.staticso2.com/_astro/1568361411373.CEiFnYYx_Z2518Ib.png)Figure 2: Reconnect the API User

**Check the Salesforce API User settings in your Salesforce account**

The [Salesforce API User](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/connecting-salesforce-api-user "How to connect a Salesforce API User") is used as a funnel for transferring data between OnceHub and Salesforce. If the API user is properly connected and a global connection problem still exists, it may be the case that changes have been made to the Salesforce API User license, a System Administrator profile, and the OnceHub permission set.

### Check the API Usage limit in the past 24 hours

[Section titled “Check the API Usage limit in the past 24 hours”](#check-the-api-usage-limit-in-the-past-24-hours)

Each Salesforce organization has a limited number of API calls. Each Salesforce organization can be integrated with several applications at a time—OnceHub may just be one of many applications talking with your Salesforce account. This [limited number of API calls per Salesforce organization](https://help.salesforce.com/articleView?id=000003706\&type=1) is made available every 24 hours. The number of API calls depends on your contract with Salesforce.

If you have exceeded the API call limit for your Salesforce account, the OnceHub connector for Salesforce will not be able to make API calls to your Salesforce account and [connected Users](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/connecting-to-salesforce "Connecting to Salesforce") will not be able to accept bookings.

In your Salesforce account, you should check the API Usage limit across your third-party applications and adjust your settings. Go to the **Setup** page, then select **Platform tools → Environments → System Overview**. [Learn more about System Overview: API Usage](https://help.salesforce.com/articleView?id=dev_force_com_system_overview_api.htm\&type=5)

## Issues affecting only single Users connected to Salesforce

[Section titled “Issues affecting only single Users connected to Salesforce”](#issues-affecting-only-single-users-connected-to-salesforce)

There are many ways in which OnceHub bookings can update Salesforce. For example, some bookings may be made with existing Salesforce contacts and not create new records, while others can be made with Leads and create new Lead records in Salesforce. Since most Salesforce organizations have a wide range of required fields and validation rules, these rules may block specific booking scenarios and not allow creation of new records in Salesforce.

When validation errors are encountered, you need to pinpoint the validation problem by identifying the Booking pages and Salesforce standard objects that are affected. In this case, you should first check the [Field validation step ](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")of the Salesforce connector setup process. Then you should check if you have [custom fields that are universally required in Salesforce and not supported by the integration](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/supported-and-non-supported-field-types-in-salesforce-integration "Supported and non-supported field types in the Salesforce integration").

### Check the Field validation step of the Salesforce connector setup process

[Section titled “Check the Field validation step of the Salesforce connector setup process”](#check-the-field-validation-step-of-the-salesforce-connector-setup-process)

You might have recently added [universally required custom fields](https://help.salesforce.com/articleView?id=fields_about_universally_required_fields.htm\&type=5) to the affected Salesforce object. When these fields are supported field types in the Salesforce integration and do not have a Salesforce default value, they will appear in the Field validation step of the Salesforce connector setup process.

When a booking is made and a required field in Salesforce has not been mapped to a field in OnceHub, a Field validation error will be detected. OnceHub will pass a default value to the field in Salesforce. [Learn more about default values for universally required fields](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")

### Check for non-supported universally required custom fields

[Section titled “Check for non-supported universally required custom fields”](#check-for-non-supported-universally-required-custom-fields)

You might have recently added universally required custom fields to the affected Salesforce object. When these [fields are non-supported field types in the Salesforce integration](https://help.staticso2.com/scheduleonce/account-integrations/crm/salesforce/supported-and-non-supported-field-types-in-salesforce-integration "Supported and non-supported field types in the Salesforce integration") and do not have a Salesforce default value, they will be indicated in the [Field validation step](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") of the Salesforce connector setup process and will not be able to accept a value from OnceHub. The only solution to this is to set these fields as non-mandatory for the affected Salesforce object, or to set a default value in Salesforce. If you cannot associate a default value for these fields in Salesforce and still want these fields to be required fields for manual entry, you can make these fields required on the Page Layout of the object. [Learn more about Page Layouts](https://help.salesforce.com/articleView?id=customize_layoutoverview.htm\&type=5)

## Other issues

[Section titled “Other issues”](#other-issues)

If you’re still seeing issues, please [contact us](https://help.staticso2.com/contact-us/) and we’ll be happy to assist you.
