Connecting a Salesforce API User

The Salesforce setup process includes 5 phases: API connection, Installation, Field validation, Field mapping, and Creation rules.

Since the OnceHub connector can create new standard records when a booking is made, it is critical that the permission to create new records always exists. For this reason, all API calls between OnceHub and Salesforce are made via a special API User that is granted the appropriate Permission Set. This ensures that new records can always be created, and at the same time, the permissions of individual Salesforce users are not altered.

You can also connect the OnceHub connector for Salesforce to a Salesforce Sandbox environment and keep your Salesforce connector setup when switching back to your production environment. Learn more about connecting to a Salesforce Sandbox environment

Caution

The API User does not need to be unique for OnceHub. If you already have an API User that is used to connect to a different third-party application, you can use that API User for the OnceHub connection.

In this article, you will learn how to connect OnceHub to an API User created in your Salesforce production account or in your Salesforce sandbox environment.

Requirements

To connect the API User to OnceHub, you must be:

• A OnceHub Administrator.
• A Salesforce Administrator for your organization.

You do not need an assigned product license to install and update Salesforce account settings. Learn more

The Salesforce API User

To connect to OnceHub, the Salesforce API User must have the following characteristics in your Salesforce account:

• The User License field must be Salesforce. The Salesforce User License is designed for Users who require full access to standard CRM and Force.com AppExchange apps. Users with this User License are entitled to access the OnceHub connector for Salesforce managed application.
• The Profile field must be System Administrator. The System Administrator profile must include the API Enabled profile permission and the ModifyAllData permission to ensure the access to the OnceHub connector for Salesforce connected app.

Connect to a Salesforce API User

Caution

You must sign out of Salesforce before proceeding so that the connection is using the API User created above. This ensures all communication between OnceHub and Salesforce is via the correct User.

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. In the Salesforce box, click the Setup button (Figure 1). Figure 1: Set up API Connection in OnceHub

6. On the API Connection step, click Connect an API User to connect to an API User created in your Salesforce production environment (Figure 2). Figure 2: Connect an API User

7. If you’re testing the connector in your Salesforce sandbox environment, you should check the Connect to a Salesforce Sandbox environment checkbox and connect to an API User created in your Salesforce Sandbox environment (Figure 3). Figure 3. Connect to a Salesforce Sandbox environment

8. On the Salesforce sign-in page, enter the Username and Password of your API User.

   Caution

   ImportantIf OnceHub automatically logged you to the wrong Salesforce User, you must disconnect and log out of Salesforce before trying to connect to the API User again.

9. On the Allow Access page, click Allow (Figure 4).

10. You are redirected back to OnceHub and the API User is now connected (Figure 5).Figure 5: API User is connected

11. Click Continue to begin the installation.