Start a conversation

Installation, configuration and authorizing access to SFDC

There are five steps to configuring SFDC two say sync with CustomerSuccessBox

  1. Salesforce OAuth authorization in CustomerSuccessBox
  2. Set-up remote site settings in Salesforce
  3. Install CustomerSuccessBox app in Salesforce from Appexchange
  4. Configure CustomerSuccessBox app in Salesforce
  5. Set-up visual force component in Salesforce

STEP 1: Salesforce OAuth authorization in CustomerSuccessBox

Follow the steps below to authorize CustomerSuccessBox access to Salesforce using OAuth

  1. Log-in to your CustomerSuccessBox instance 
  2. Navigate to the Integrations Hub from Settings > Integrations 
  3. Find and click on Salesforce in the Integrations Hub and click Connect now > Choose whether sandbox or Production > Authorize 
  4. You will be redirected to the Salesforce authorization page. Scroll down and click Authorize Access

Required oAuth Salesforce user permission set

Salesforce Object
Write *
Salesforce Account
CSB Settings (custom object) - created by CustomerSuccessBox App
CSB Account (custom object) - created by CustomerSuccessBox App
Salesforce Activity (Tasks and Events)
Salesforce Notes
Custom Object

Write permissions are only required if you are installing CustomerSuccessBox app and looking to facilitate two-way sync.

STEP 2: Set-up remote site settings

Set-up remote site settings in Salesforce by following the steps below. 

  1. Click on Setup (top right of the Salesforce Classic)
  2. Search and Click on Remote Site Settings
  3. Click New
  4. Enter CSB in Remote Site Name
  5. Enter you CustomerSuccessBox instance url in the Remote Site URL box
  6. Check the 'Active' radio box

STEP 3: CustomerSuccessBox app installation in Salesforce

Follow the below steps to install CustomerSuccessBox app in Salesforce. 

  1. Access CustomerSuccessBox app for Salesforce on AppExchange:
  2. Click on "Get it Now" Button on top-right to start the installation process. You may need to log into your Salesforce instance.
  3. Choose a set of users who can access this app

That's it! CustomerSuccessBox app is installed in Salesforce

STEP 4: CustomerSuccessBox app configuration in Salesforce

Follow the below steps to authorize and configure CustomerSuccessBox app in Salesforce

  1. Once the installation is complete, navigate to the CustomerSuccessBox App by clicking on Content on the upper right-hand corner.

  2. Navigate to the CSB Settings tab and click New

  3. Review and the details of the integration in the Overview screen and click Next

  4. Enter below details in the Authorization screen
    • Enter your Domain name. For example: If your CustomerSuccessBox URL is, then 'companyname' would be the domain name

    • Navigate to Settings > Developer Console in CustomerSuccessBox and copy Secret Key from under API Key tab

    • Enter Secret key  and click Authorize

  5. In the Configuration screen, select how you want to sync Account,Subscription,User and Invoice data from Salesforce. You may choose any one of the below options from the dropdown. 
    • Create Only: Only creates new Accounts,Subscriptions, Users in CustomerSuccessBox from Accounts, Opportunities, Contacts Objects in Salesforce . If the data in any of the above objects is updated in Salesforce, they will NOT be updated in CustomerSuccessBox. This option is not available for Invoice data sync
    • Create and Update: Both creates and updates Accounts,Subscriptions, Users, Invoices in CustomerSuccessBox from Accounts, Opportunities, Contacts, (custom) Invoice Objects in Salesforce . If the data in any of the above objects is updated in Salesforce, they will be updated in CustomerSuccessBox as well. 
    • Do Not Sync: You may choose to not sync data from a specific object in Salesforce to CustomerSuccessBox by selecting this from the dropdown.
  6. Select the field containing the unique CustomerSuccessBox Account identifier on Salesforce Account Object
  7. Select the field containing the unique CustomerSuccessBox Subscription identifier on Salesforce Opportunity object. Select the Opportunity 'Stages' and 'Types' for which you prefer to create subscriptions in CustomerSuccessBox
  8.  Select the field containing the unique CustomerSuccessBox User identifier on Salesforce Contacts object
  9. Select the unique Invoice object containing the CSB Invoice identifier and select field containing the unique CSB Invoice identifier on Salesforce Invoice. Also, select field which contain relationship with selected account object of salesforce
  10. Select Back Import Checkbox if need to sync existing data from Salesforce to CSB
  11. Select the checkboxes under Activities Settings to sync Tasks/Notes/Logs according to 1-way/2-way requirement. Click Next
  12. Complete mapping data for Account, Subscription, Contacts and Invoice objects in the Account Mapping, Subscription Mapping, User Mapping and Invoice Mapping screens. 
    • Select the appropriate fields in Salesforce objects from which the data should be pulled from. 
    • Click Next when you have completed mapping data for each Salesforce object
    • You may select 'Do Not Sync' in case you do not want to pull data for a specific CustomerSuccessBox field
  13. Click on Start Back Import to sync existing data. You may slick Back to move to previous screen and select Start Over to start again. 
  14. Click on Done to complete the integration

Voila! You are done with the installation. Read on to understand layout changes that are recommended.

Step 5: Setting up Visualforce Component

This will set-up a CustomerSuccessBox visual force component in Salesforce

  1. Navigate to Setup > Customize > Account > Page Layouts
  2. Click Edit in front of the page layout you want to place Visualforce component on
  3. Click on Visualforce Pages section. Select, drag and drop a Section on  the page layout
  4. Enter CustomerSuccessBox in the Section NameClick 1-Column in LayoutClick the checkboxes that are appropriate for you in Display Section Header On
  5. Drag and drop csb_account visualforce page in the newly created section that was just created
  6. Click on the Properties (Spanner icon) on the csb_account visualforce page, set height to 700px, click OK and Save

That's it! CustomerSuccessBox and Salesforce two way sync is set up!! You will be able to see the CSB Account healths under the Account in Salesforce! 

Contact Us

In most cases, you would have a dedicated Customer Success Manager who will be your point-of-contact for any queries or assistance. You may also,

  1. Initiate a chat directly from within CustomerSuccessBox. Use chat option with Live Chat option under help (?) tab present on the top navigation bar
  2. Create a conversation from here
  3. Send an email to

Overview: Integrating Salesforce with CustomerSuccessBox
Prerequisites: Integrating Salesforce with CustomerSuccessBox
Technical Details: CustomerSuccessBox app for Salesforce
Choose files or drag and drop files
Was this article helpful?
  1. Ashok Patel

  2. Posted