This article is updated to our latest release, which is being rolled out to all Users gradually.
If you see a Schedule button in the top navigation menu, you are viewing the updated version of OnceHub. Otherwise, you can expect to see this in the near future. Please contact us with any questions.
Since the ScheduleOnce 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 ScheduleOnce 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 ScheduleOnce 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
Important The API User does not need to be unique for ScheduleOnce. 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 ScheduleOnce connection.
In this article, you will learn how to connect ScheduleOnce to an API User created in your Salesforce production account or in your Salesforce sandbox environment.
To connect the API User to ScheduleOnce, you must be:
- A OnceHub Administrator.
- A Salesforce Administrator for your organization.
The Salesforce API User
To connect to ScheduleOnce, 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 ScheduleOnce 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 ScheduleOnce connector for Salesforce connected app.
Connect to a Salesforce API User
Important You must sign out of Salesforce before proceeding so that the connection is using the API User created above. This ensures all communication between ScheduleOnce and Salesforce is via the correct User.
- Go to Setup -> ScheduleOnce setup in the top navigation bar.
- Open the lefthand sidebar and select Integrations -> CRM integration.
- In the Salesforce box, click the Setup button (Figure 1).
- On the API Connection step, click Connect an API User to connect to an API User created in your Salesforce production environment (Figure 2).
- 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).
- On the Salesforce sign-in page, enter the Username and Password of your API User.
ImportantIf ScheduleOnce 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.
- On the Allow Access page, click Allow (Figure 4).
- You are redirected back to ScheduleOnce and the API User is now connected (Figure 5).
- Click Continue to begin the installation.