---
title: "Salesforce Integration: Configuration"
url: "https://help.psarev.io/en/article/salesforce-integration-configuration"
language: "en"
last_updated: "2026-11-18T19:32:16.568Z"
---

# Salesforce Integration: Configuration

| **NOTE:** An authorized user account is required to run this integration. To support better security and audit visibility, we recommend creating a dedicated "service account" user. When configuring this integration, sign in using the service account rather than your personal user account to ensure that audit logs reflect the service account running the integration instead of the user who originally installed it. |
| --- |

Complete the steps below to configure the Salesforce integration.

| **NOTE:** Before starting the configuration steps below, be sure you have completed the required prerequisite steps, including creating the three custom fields in Salesforce. See the [Salesforce Integration: Prerequisites](https://help.psarev.io/en/article/salesforce-integration-prerequisites) article for more information. |
| --- |

1.  Click **Admin** on the sidebar menu and select **Integrations Library**.
2.  Click the *Marketplace* tab.
3.  Locate and select the **Salesforce** integration in the CRM area.
4.  Click the **Configure** button.
5.  The *Initial Configuration* section is automatically populated. Click the **Next** button.
6.  On the *Connections* page, enter your Salesforce connection details as described in the first table below, and then click the **Next** button.
7.  On the *Sync Settings* page, configure the settings described in the second table below, and then click the **Next** button.
8.  On the *Opportunity Sync* page, configure the settings described in the third table below. Then, click the **Finish** button.
9.  If **Enable Initial Sync** is checked, the integration runs the one-time sync of your existing Salesforce data. **Do not leave this page while the sync is running.** If you need to work on something in the system while the integration syncs, open Rev.io in another tab.

Each setting on the *Connections* page is defined below.

| **Label** | **Definition** |
| --- | --- |
| **Salesforce Connection** | *Your Salesforce username, password, security token, and login URL. See the* [*Salesforce Integration: Prerequisites*](https://help.psarev.io/en/article/salesforce-integration-prerequisites) *article for more information.* |
| **Rev.io PSA Connection** | *Filled in for you. No changes are needed.* |
| **Production Mode** | *Leave this checked. It is only unchecked for testing.* |

Each setting on the *Sync Settings* page is defined below.

| **Label** | **Definition** |
| --- | --- |
| **Account Type Filter** | *Salesforce account types to sync. Leave this blank to sync all accounts regardless of type.* |
| **Opportunity Stage Filter** | *Only syncs accounts that have opportunities at the selected stages. Leave this blank to include all accounts.* |
| **Bill Profile ID** | *Rev.io bill profile assigned to new customers. Leave this as **0** to use your default bill profile.* |
| **Sync Schedule** | *How often the scheduled sync runs. The default is daily at 3:00 AM. Running more often than every 12 hours is not recommended.* |
| **Batch Size** | *The most records processed in each sync run. The default is 50. Increase it if you have a large amount of Salesforce data.* |
| **Enable Initial Sync** | *Check this option to run the one-time sync of your existing Salesforce data when setup finishes. Uncheck it only if you want to skip importing your existing records.* |
| **Debug Mode** | *Turns on detailed logging for troubleshooting. Leave this unchecked for normal use.* |

Each setting on the *Opportunity Sync* page is defined below. The **Status Map** and **Stage Map** lists are filled in from your Salesforce and Rev.io accounts, so you select values instead of typing them.

| **Label** | **Definition** |
| --- | --- |
| **Opportunity Trigger Stages** | *Salesforce stages that sync opportunities to Rev.io. Leave this blank to turn off opportunity sync. Accounts and contacts still sync.* |
| **PSA Default Stage** | *Rev.io stage used for new opportunities when a Salesforce stage is not in the **Stage Map**. The list shows the stages in your Rev.io account.* |
| **PSA Default Type** | *Rev.io type used for new opportunities.* |
| **PSA Default Status** | *Rev.io status used for new opportunities when a Salesforce stage is not in the **Status Map**.* |
| **PSA Default Owner User ID** | *Rev.io user ID used as the opportunity owner when no Rev.io user's email matches the Salesforce opportunity owner. Leave this as **0** if you don't want a fallback owner.* |
| **Closed Lost Reason** | *Text entered in the lost reason field when a Closed Lost opportunity syncs. The default is Closed Lost in Salesforce.* |
| **Status Map** | *Matches each Salesforce stage to a Rev.io status, such as Closed Won to Won.* |
| **Stage Map** | *Matches each Salesforce stage to a Rev.io stage, such as Prospecting to Discovery.* |

For more information about the Salesforce integration, see the following articles.

[Salesforce Integration: Overview](https://help.psarev.io/en/article/salesforce-integration-overview)  
[Salesforce Integration: How the Sync Works](https://help.psarev.io/en/article/salesforce-integration-how-the-sync-works)
