Convertr Help Centre Help Center home page
Submit a request
Sign in
  1. Convertr Help Centre
  2. Product
  3. Leads - Delivery - Generic Integrations

Integrating with Salesforce Follow

Overview

Our Salesforce integration allows you to link directly into a Salesforce instance and upload your lead data in an automated fashion.

This is the most secure way to transfer lead data from the platform to a Salesforce instance. Our integration takes advantage of the Create Record endpoint to create a lead. You can create or update an existing lead as well as route directly to a Salesforce campaign.

 

Prerequisites

Please ensure that you have the following details from the client before progressing with the integration:

  • You will need a user account in the Salesforce instance you wish to integrate to. This will provide you with the username, password, and security token you need. This needs to have access to read/write lead data.
  • Salesforce REST API field names for the data you wish to submit.
  • Client ID and Client Secret - this requires your client to have a Connected App built in Salesforce that can supply these.

 

Configuration

1.  Within your campaign, go to the Processr tab, navigate to Integration and click Add Job.

Screenshot showing the Processr tab with the Integration section and Add Job button highlighted

2. In the drop-down, choose Salesforce Integration and click Save. 

Screenshot showing the Salesforce Integration option selected in the drop-down menu

3. Select whether or not you'd like to update existing records by entering yes or no.

Screenshot showing the input field to specify whether to update existing records

4. Fill in the fields which have been provided by the client.

Screenshot showing the fields to be filled with client-provided details

How to retrieve these details from Salesforce:

a. username (details used to login to the Salesforce account)

b. password (details used to login to the Salesforce account)

c. clientId and clientSecret

Please Note: This is known as the Consumer Key and Consumer Secret in Salesforce.

i. Once you are logged in to your account, click Setup.

Screenshot showing the Salesforce Setup option

ii. Select Apps manager > App Manager.

Screenshot showing the App Manager in Salesforce

iii. Beside the App that you would like to connect to, select 'View'.

Screenshot showing the View option beside a Salesforce app in App Manager

iv. Copy over the Consumer Key and Consumer Secret (Click to Reveal).

Screenshot showing the Consumer Key and Consumer Secret fields in Salesforce

d. securityID

Please Note: This is known as the Security Token in Salesforce.

The owner of the account should have received an email with this ID when the account was created. 

However, if this email cannot be found you should be able to reset the token in the Settings area of your account:

Screenshot showing how to reset the security token in Salesforce

e. apiUrl 

i. The following is the structure for the apiURL field. You will need to replace [login] with the URL you find in the next step for your unique URL. 

https://[login.my.salesforce.com]/services/oauth2/token

ii. In Salesforce, select the profile icon in the top right corner of the page and copy the URL next to your avatar and update the URL structure shown above.

Please note: If using the URL login.salesforce.com, you do not need to include [my.] as indicated in the code block above.

Screenshot showing how to find and copy the unique Salesforce URL

5. Enter the client’s field names and map them to the Convertr field names, then click Save.

Please note: The client’s field names should be entered on the left and the matching Convertr field names are entered on the right.

Screenshot showing how to map client field names to Convertr field names

The last (highlighted) field, is an optional field. It can be used to route leads to campaigns within Salesforce. There is the option to either hardcode a single value which will route leads to a single campaign or you can pass different campaign IDs from the form capture to route into multiple campaigns. 

Articles in this section

  • HTTP Integration Examples: Hubspot Forms
  • HTTP Integration Example - Pardot Form Handlers
  • Scheduled Delivery
  • Integration Requirements
  • Multiple Campaign Integration
  • List of Convertr Supported Integrations and Their Versions
  • Additional Integration Fields
  • HTTP Integration Example: Salesforce Web-to-Lead
  • The Credentials Manager
  • HTTP Integration Example: Eloqua Forms
See more

Related articles

  • HTTP Integration Example: Salesforce Web-to-Lead
  • Integration Requirements
  • Value Transforms: Regex Find and Replace
  • Getting Your Campaign Started
  • Metadata
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Return to top

Related articles

  • HTTP Integration Example: Salesforce Web-to-Lead
  • Integration Requirements
  • Value Transforms: Regex Find and Replace
  • Getting Your Campaign Started
  • Metadata
Convertr