Salesforce Integration: Prerequisites

Complete the following prerequisite steps before configuring the Salesforce integration in your Rev.io instance.

The integration needs three custom fields in Salesforce to keep track of which records are already linked to Rev.io. After it matches or creates a record, the integration writes the Rev.io ID into the field, which creates a permanent link between the two records. Create the following fields in Salesforce.

ObjectCustom Field
AccountField API name Rev_io_ID__c, type Text with a length of 50. Stores the linked Rev.io customer ID.
ContactField API name Rev_io_Contact_ID__c, type Text with a length of 20. Stores the linked Rev.io contact ID.
OpportunityField API name Rev_io_ID__c, type Text with a length of 50. Stores the linked Rev.io opportunity ID.

Follow the steps below to create each custom field in Salesforce.

  1. In Salesforce, open Setup and select Object Manager.
  2. Select the object, such as Account.
  3. Select Fields & Relationships and click New.
  4. Select Text as the data type, and enter the length from the table above.
  5. Enter the field name so the API name matches the table above exactly, and save the field.

See the Salesforce help documentation for more details on creating custom fields.

Gather the following Salesforce login details. You enter them during configuration.

LabelDefinition
UsernameThe Salesforce username the integration signs in with.
PasswordThe password for that Salesforce user.
Security TokenThe Salesforce security token for that user. To get a new token, open your Salesforce Settings, select Personal Settings, and select Reset My Security Token. Salesforce emails the new token to you.
Login URLhttps://login.salesforce.com for production, https://test.salesforce.com for a sandbox, or your My Domain URL, such as https://yourcompany.my.salesforce.com, if your company uses a custom domain.

The Rev.io connection details are provided for you during setup, so you don't need to gather anything for Rev.io.

When you are finished with the prerequisite steps, see the Salesforce Integration: Configuration article to set up the integration.