Salesforce is an industry leader in enterprise CRM. It offers a suite of enterprise applications revolving around marketing automation, customer engagement and support, application development as well as analytics.
This guide is aimed at helping you set up Salesforce as a source in RudderStack in the easiest possible way. With this integration, you can send your Salesforce data to RudderStack as events, which can then be further routed to your preferred third-party destinations.
To set up Salesforce as a source on the RudderStack dashboard, follow these steps:
Sign into your RudderStack dashboard.
Click on Sources on the left panel of your dashboard. Select Salesforce, and then click on Next.
Assign a name to your source, and click on Next.
Next, you will be required to connect your Salesforce account with RudderStack. To do so, click on Connect with Salesforce. After allowing the necessary permissions, your account should be successfully connected to RudderStack and visible on the dashboard. Then, click on Next.
In the next window, select the suitable Run Frequency. This configuration controls how often RudderStack will pull data from your Salesforce integration. Then, click on Next.
Finally, specify the Salesforce data you want to import via RudderStack, and click on Next. You can choose to import selected Salesforce resources or all of them.
That's it! Salesforce is now successfully configured as a source on your RudderStack dashboard. RudderStack will start ingesting data at the specified frequency. You can further connect this source to your data warehouse or other third-party destinations by clicking on Connect Destinations or Add Destinations, as shown:
The following sections will help you better understand the overall replication process once RudderStack connects to your Salesforce data source.
When RudderStack first connects to your Salesforce data source, it will pull all your historical data.
RudderStack synchronizes with your Salesforce data source based on the schedule and run frequency you choose while configuring the source.
The first time RudderStack syncs with your Salesforce data, it performs a full replication - as mentioned above. After that, your Salesforce data is replicated incrementally. This means that RudderStack will replicate only the new and updated rows to your destination.
Salesforce imposes a strict API quota that regulates its API usage. This quota corresponds to the total number of API requests that can be made over a period of time.
Here's how RudderStack handles these API quotas:
If a single replication attempt utilizes 20% of your daily quota, the replication process will stop.
If more than 80% of your daily API quota has been utilized (by RudderStack or any other apps), the replication will stop. The process will resume once the API limit is lifted.
Salesforce has a Production and a Sandbox Environment. In case you need to work with both your production as well as development data, it is recommended that you create two pipelines.
To connect to your sandbox environment, follow these steps:
Create a new Salesforce data pipeline.
Check the Connect to Sandbox Account option and click Connect with Salesforce button, as shown:
Use your sandbox account credentials to log in and continue with the rest of the setup.
If you come across any issues while configuring Salesforce as a source with RudderStack, please feel free to contact us. You can also start a conversation on our Slack channel; we will be happy to talk to you!