Connect Salesforce to OnRamp

Updated

Who can do this: Super Admins and Integrators

Connect your Salesforce org to OnRamp from Settings > Integrations+. Once it's connected, you can set up workflows that create projects from Salesforce records, and automations that send data back to Salesforce.

Before you begin

  • Have a Salesforce login that can approve the connection. To choose the right Salesforce user and give it the permissions OnRamp needs, see Configure Salesforce permissions for OnRamp project automation.

  • Pick an active Salesforce user that doesn't already have 5 OnRamp connections. Salesforce allows 5 OnRamp connections per Salesforce user, and connecting a 6th disconnects the oldest.

  • Know which org you're connecting: Production, Sandbox, or an org with its own domain.

Connect Salesforce

  1. Go to Settings > Integrations+. The page lists the CRMs you can connect, including Salesforce and HubSpot.

  2. Select the Salesforce card. A Connect to Salesforce dialog opens.

  3. Choose the org to connect. Salesforce Production is selected by default. The field you see depends on your organization:

    • When OnRamp-run Salesforce connections are turned on for your organization, the field is Environment. It offers Salesforce Production, Salesforce Sandbox and My Domain. If you choose My Domain, enter your My Domain URL.

    • Otherwise, the field is Instance auth setting. It offers Salesforce Production, Salesforce Sandbox and Salesforce Custom. If you choose Salesforce Custom, enter the Authorize URL, Token URL and Revoke URL.

  4. Select Confirm. With Environment, OnRamp takes you to Salesforce in the same tab. With Instance auth setting, Salesforce opens in a new window.

  5. Sign in to Salesforce if prompted, and approve access for OnRamp.

Back in OnRamp, the connection finalizes on its own. With Environment, you return to Integrations+ and see Salesforce connected. With Instance auth setting, you see Integration added and deployed once it finishes deploying. The Salesforce card then shows a status of Enabled.

What connecting lets you do

Connecting Salesforce makes these features available. Each one runs only once you set it up:

Manage the connection

To open the connection, go to Settings > Integrations+ and select the Salesforce card. For a connection made with Environment, the page's Details tab shows:

  • Status: for example, Enabled or Disconnected.

  • Created: when the connection was made.

  • User: the Salesforce user who connected it.

  • Account: the Salesforce instance URL, as a link. Use it to check which org you connected.

When CRM field sync is turned on for your organization, people who can view field sync also see a Field mappings tab.

For a connection made with Environment, the page has two actions:

  • Refresh Data: updates OnRamp's cache of Salesforce objects and fields. Nothing changes in Salesforce. Use it when automations show stale picklist options or missing fields. See Salesforce picklist options don't match in automation actions. It appears only to people allowed to refresh CRM data.

  • Disconnect Integration: stops using the connection. It appears only to people who can manage integrations.

People without either permission see neither action.

Warning: Disconnecting revokes OnRamp's access in Salesforce and archives the links between OnRamp records and Salesforce records. OnRamp deletes the connection record. When connection retention is turned on for your organization, OnRamp keeps it instead, and reconnecting the same Salesforce org brings back its links and field mappings.

Switch to a different org

If you connected the wrong org, follow these steps:

  1. Open the Salesforce connection and check Account on the Details tab.

  2. Select Disconnect Integration, then confirm. You see Integration disconnected, and OnRamp returns you to Integrations+.

  3. Follow the steps in Connect Salesforce again and choose the right org.

If the connection doesn't work

  • The connection didn't complete: you'll see We could not complete the CRM connection. Please try connecting again. Select the Salesforce card and connect again. If it keeps failing, check the Salesforce user's permissions with your Salesforce administrator.

  • The status reads Disconnected: Salesforce revoked the connection, and the page explains why. Usually the Salesforce user went over the limit of 5 OnRamp connections, so connecting a 6th disconnected the oldest. It can also mean the Salesforce user was deactivated. For a connection made with Environment, disconnect and reconnect the integration, signing in as a different or active Salesforce user.

  • You can't select the Salesforce card: if Salesforce isn't connected yet and the page shows We could not load the status of your connections., the card shows Status unavailable. Reload the page to try again. People without permission to manage integrations can't select the card to start a new connection, though they can open it once Salesforce is connected. Ask a Super Admin or Integrator.

More in Native Integrations