Context
Demandbase connects to your Salesforce through a Connected App and a dedicated Salesforce user profile.
Prerequisites
- Important: As a best practice, we highly recommend that you create a dedicated Salesforce API user profile that Demandbase can use to synchronize with Salesforce via the Salesforce API. This practice makes it much easier to manage authentication credentials in the event that the dedicated Salesforce user leaves the company or changes roles. See the Salesforce instructions for how to Create a Secure Salesforce API User.
- You must haveAdmin privileges within your Salesforce environment.
- Make sure you have the required Salesforce permissions. See Best Practices: Salesforce Permissions.
- Install our latest AppExchange Package: Salesforce AppExchange: Demandbase (ABX Cloud) Package.
Important: Even if you already had the Demandbase package installed, you'll need the latest version to access all of the components. When you log in to Salesforce and check out the AppExchange listing, it will tell you what version you have and what the latest version is.
Steps
Create a Connected App in Salesforce
- Log in to Salesforce as an Admin user.
- Click on Setup (Salesforce Classic) or the Setup Icon (Salesforce Lightning) at the top right of the page.
- For Salesforce Classic:
- In the left panel, go to Build > Create > Apps.
- Scroll down to the Connected Apps section, click New.
- For Salesfore Lightning:
- In the left panel, go to Apps > App Manager.
- Click the New Connected App button at the top right of the page.
- In the Basic Information section:
- Enter Demandbase ABM as the Connected App Name.
- Keep the default API Name, Demandbase_ABM.
- Enter support@demandbase.com as the Contact Email.
- Check the Enable OAuth Settings checkbox.
- In the API (Enable OAuth Settings) section:
- In separate lines, enter https://web.demandbase.com/admin/oauthcallback and https://authentication.demandbase.com/oauth2/v1/authorize/callback in the Callback URL. Do not separate the URLs using commas, semicolons, or other characters.
- Add the following OAuth scopes:
- If your SFDC Release version is prior to Winter '22 Patch 6.0 release,
- Access and manage your data (api)
- Access your basic information
- Allow access to your unique identifiers (openid)
- Perform requests on your behalf at any time (refresh_token, offline_access)
- If your SFDC Release version is after Winter '22 Patch 6.0 release,
- Access the identity URL service (id, profile, email, address,
phone) - Access unique user identifiers (openid)
- Manage user data via APIs (api)
- Perform requests at any time (refresh_token, offline_access)
- Access the identity URL service (id, profile, email, address,
- (Optional) If you are integrating Pardot, add Manage Pardot services scope.
- If your SFDC Release version is prior to Winter '22 Patch 6.0 release,
- Click Save.
- Click Continue in the New Connected App warning page.
Verify users permitted to OAuth
- In Setup, quick find Connected Apps (Salesforce Classic) or Manage Connected Apps (Salesforce Lightning.)
- Click the Edit link next to Demandbase ABM.
- Under the OAuth Policies section, make sure that the Permitted Users is set to All users may self-authorize. The app should be usable to all applicable users.
- Important: If you select the Admin approves users pre-authorized option, each User Profile that needs access will need to be explicitly added to this Connected App.
- Make sure that the Refresh Token Policy is set to Refresh token is valid until revoked.
- Click Save.
Retrieve Consumer Key and Consumer Secret from Salesforce
- For Salesforce Classic:
- In Setup, go to Build > Create > Apps. Click the word Demandbase ABM (not Edit or Manage.)
- In Setup, go to Build > Create > Apps. Click the word Demandbase ABM (not Edit or Manage.)
- For Salesforce Lightning:
- In Setup, go to Apps > App Manager. Look for Demandbase ABM.
- Scroll to the right and click on the arrow > View.
- In the API (Enable OAuth Settings) section, click Manage Consumer Details.
- Copy the Consumer Key and Consumer Secret.
Outcome
Copy your Consumer Key and Consumer Secret for the next step.