Overview

Salesforce offers social and mobile cloud technologies that help companies connect with customers, partners, and employees. This integration enables you to get a total view of your sales funnel and your entire business while displaying current data for all of your customers. This article will give you an overview of the Salesforce/Grow integration and what you can expect:

• Data Warehouse
• Direct Query
• Endpoints
• API Docs
• FAQs

Time Zone

Coordinated Universal Time (UTC) — All date and timestamps are stored in UTC. If account timezone settings are set in Grow, these times will adjust accordingly. For more information, visit this Help Center article.

Data Source Features

Connection Type	Release Status
Data Warehouse	Alpha/Beta
Direct Query	Supported

Data Warehouse

Salesforce is on the Grow Data Warehouse, which we highly recommend you use. For more information about warehousing your data, visit the Data Warehouse Help Article.

Suggested Tables

These 6 Salesforce API standard objects are available in Grow:

1. Accounts
2. Contacts
3. Events
4. Leads
5. Opportunities
6. Tasks

Other Tables

You can access other standard objects and custom objects in the "Other Tables" section. There are 300+ other Salesforce objects; you can search through the list by scrolling (or by keyword for faster search) and select the objects that are most relevant.

Custom Tables

Additionally, you can pull in data using SOQL by using the "Custom Tables" section. For detailed instructions for writing your own SOQL queries, refer to the section further down in this article called How do I Write a Custom SOQL Query?

 

Workflow

1. When you have finished selecting the data that you want stored in Grow’s Data Warehouse, click the “Sync & Store” button at the bottom.
2. This will begin the initial population of your warehouse with the tables you defined. Populating your data warehouse for the first time may take a while, even up to several hours.
3. While your data is "In Queue" or "Processing", you may continue working within the app.
4. After the initial update is complete, you can modify the refresh rate as needed.

Refresh Strategy

***Refresh strategies are tied to specific endpoints. More information on this coming soon.

 

Direct Query

A direct query connection can be used to pull data into Grow. With abnormal usage, Direct Query can run into API limitations depending on the data source. For this reason, we recommend that you use Grow's Data Warehouse for a more performant, reliable experience.

Support Status

Direct Query

Currently supported with no projection to stop maintaining

 

How to Connect

1. Click on the Data tab at the top left of the global navigation. Then click on "Connections" in the Data Library section.
2. Click on the blue "Connect" button and search for Salesforce.
3. Click on the Salesforce logo.
4. A window will pop up to log in with your Salesforce credentials. After entering your credentials you will see a green confirmation message that the connection has been made.
   If you didn't see a window to enter your credentials but you still got a green success message, then that means you were already logged in with your Salesforce account (likely in another tab) and Grow used that account to connect.

Building a Metric

To help you get started in Salesforce, here's a quick tutorial for building a metric that tracks the new leads by week over the last 6 months. It also briefly covers the different kinds of reports you can use to bring in Salesforce data:

 

Endpoints

Grow’s Salesforce integration is extremely robust. You have three options for pulling data into Grow: Reports, Saved Reports, or Write SOQL. Each one of these then further provides a myriad of possibilities to pull data in.

Reports will bring in the most unfiltered data from Salesforce. In addition to standard Salesforce reports, Grow can pull in any other tables your account is connected to in Salesforce, making the integration very dynamic.

The following list shows the standard reports in Salesforce, along with some of the standard fields each report provides. The Salesforce/Grow integration also offers other sub-types of these reports as well as any other custom reports or fields you have set up in your Salesforce account:

REPORT: Activities

• Task Fields: Assigned To, Call Duration, Call Object Identifier, Call Result, Call Type, Comments, Created By, Create Recurring Series of Tasks, Due Date, Email, Last Modified By, Name, Phone, Priority, Recurrence Interval, Related To, Repeat This Task, Status, Subject, Task Subtype, Type
• Events Fields: All-Day Event, Assigned To, Created By, Date, Description, Duration, Email, End, Event Subtype, Last Modified By, Location, Name, Phone, Private, Related To, Show Time As, Start, Subject, Time, Type

REPORT: Campaigns

• Fields: Active, Actual Cost in Campaign, Actual Cost in Hierarchy, Budgeted Cost in Campaign, Budgeted Cost in Hierarchy, Campaign Member Type, Campaign Name, Campaign Owner, Contacts in Campaign, Contacts in Hierarchy, Converted Leads in Campaign, Converted Leads in Hierarchy, Created By, Description, End Date, Expected Response (%), Expected Revenue in Campaign, Expected Revenue in Hierarchy, Last Modified By, Leads in Campaign, Leads in Hierarchy, Num Sent in Campaign, Num Sent in Hierarchy, Opportunities in Campaign, Opportunities in Hierarchy, Parent Campaign, Responses in Campaign, Responses in Hierarchy, Start Date, Status, Type, Value, Opportunities in Campaign, Value Opportunities in Hierarchy, Value Won Opportunities in Campaign, Value Won Opportunities in Hierarchy, Won Opportunities in Campaign, Won Opportunities in Hierarchy

REPORT: Leads

• Fields: Address, Annual Revenue, Campaign, Company, Created By, Data.com Key, Description, Do Not Call, Email, Email Opt Out, Fax, Fax Opt Out, Industry, Last, Modified By, Last Transfer Date, Lead Owner, Lead Source, Lead Status, Mobile, Name, Salutation, First Name, Last Name, No. of Employees, Phone, Rating, Title, Website

REPORT: Accounts

• Fields: Account Name, Account Number, Account Owner, Account Site, Account Source, Annual Revenue, Billing Address, Created By, Data.com Key, Description, Employees, Fax, Industry, Last Modified By, Ownership, Parent Account, Phone, Rating, Shipping Address, SIC Code, SIC Description, Ticker Symbol, Type, Website

REPORT: Contacts

• Fields: Account Name, Assistant, Asst. Phone, Birthdate, Contact Owner, Created By, Data.com Key, Department, Description, Do Not Call, Email, Email Opt Out, Fax, Fax Opt Out, Home Phone, Last Modified By, Last Stay-in-Touch Request Date, Last Stay-in-Touch Save Date, Lead Source, Mailing Address, Mobile, Name, Salutation, First Name, Last Name, Other Address, Other Phone, Phone, Reports To, Title

REPORT: Opportunities

• Fields: Account Name, Amount, Close Date, Contract, Created By, Description, Expected Revenue, Forecast Category, Last Modified By, Lead Source, Next Step, Opportunity Name, Opportunity Owner, Price Book, Primary Campaign Source, Private, Probability (%), Quantity, Stage, Synced Quote, Type

REPORT: Opportunity Product

• Fields: Created By, Date, Discount, Last Modified By, Line Description, List Price, Opportunity, Product, Product Code, Quantity, Sales Price, Subtotal, Total Price

REPORT: Quotes

• Fields: Account Name, Additional To, Additional To Name, Bill To, Bill To Name, Contact Name, Contract, Created By, Description, Discount, Email, Expiration Date, Fax, Grand Total, Last Modified By, Line Items, Opportunity Name, Phone, Quote Name, Quote Number, Quote To, Quote To Name, Shipping and Handling, Ship To, Ship To Name, Status, Subtotal, Syncing, Tax, Total Price

REPORT: Quote Line Items

• Fields: Created By, Date, Discount, Last Modified By, Line Item Description, Line Item Number, List Price, Product, Product Code, Quantity, Quote Name, Sales Price, Subtotal, Total Price

REPORT: Social Persona

• Fields: Are we following, Bio, Blacklisted, Created By, Followers, Following, Is following us, Klout Rating, Last Modified By, Listed Count, Number Of Friends, Number Of Tweets, Parent, Profile Type, Profile URL, Provider External Picture URL, Radian6 Media Provider, Radian6 Media Type, Radian6 Source Id, Radian6 User Id, Real Name, Social Handle, Social Network, Social Persona Provider External Id, Source App, Topic Type

REPORT: Social Posts

• Fields: Analyzer Score, Assigned To, Attachment Type, Attachment URL, Classification, Comment Count, Content, Content Clipping, Created By, Deleted By, Engagement Level, External Post Id, Harvest Date, Headline, Inbound Link Count, In Reply To, Is Outbound, Keyword Group Name, Language, Last Modified By, Liked By, Likes and Votes, Managed Social Account, Message Type, Name, Owner, Parent, Posted Date, Post Priority, Post Tags, Post URL, Radian6 Media Provider, Radian6 Media Type, Radian6 Post Id, Radian6 Source Id, Radian6 Topic Id, Recipient, Recipient Type, Response Context, Reviewed Status, Review Scale, Review Score, Sentiment, Shares, Social Handle, Social Network, Social Persona, Source Tags, Spam Rating, Status, Status Message, Thread Size, Topic Profile Name, Topic Type, Unique Commentors, View Count, Who

REPORT: Cases

• Fields: Account Name, Asset, Business Hours, Case Number, Case Origin, Case Owner, Case Reason, Case Source, Closed When Created, Contact Email, Contact Fax, Contact Mobile, Contact Name, Contact Phone, Created By, Date/Time Closed, Date/Time Opened, Description, Escalated, Internal Comments, Last Modified By, Parent, Case, Priority, Status, Subject, Type, Web Company, Web Email, Web Name, Web Phone

REPORT: Contracts

• Fields: Account Name, Activated By, Activated Date, Billing Address, Company Signed By, Company Signed Date, Contract End Date, Contract Name, Contract Number, Contract Owner, Contract Start Date, Contract Term (months), Created By, Customer Signed By, Customer Signed Date, Customer Signed Title, Description, Last Modified By, Owner Expiration Notice, Price Book, Shipping Address, Special Terms, Status

REPORT: Orders

• Fields: Account Name, Account Number, Activated By, Activated Date, Billing Address, Bill To Contact, Company Authorized By, Company Authorized Date, Contract End Date, Contract Name, Contract Number, Created By, Customer Authorized By, Customer Authorized Date, Description, Last Modified By, Opportunity, Order Amount, Order End Date, Order Name, Order Number, Order Owner, Order Reference Number, Order Start Date, Order Type, Original Order, PO Date, PO Number, Quote, Reduction Order, Shipping Address, Ship To Contact, Status

REPORT: Solutions

• Fields: Created By, Last Modified By, Public, Solution Details, Solution Number, Solution Title, Status, Visible in Public Knowledge Base

REPORT: Products

• Fields: Active, Created By, Display URL, External Data Source, External ID, Last Modified By, Product Code, Product Description, Product Family, Product Name, Quantity Unit Of Measure

REPORT: Price Books

• Fields: Active, Created By, Description, Is Standard Price Book, Last Modified By, Price Book Name

REPORT: Price Book Entries

• Fields: Active, Created By, Last Modified By, List Price, Price Book, Product, Product Code, Standard Price, Use Standard Price

REPORT: Badges

• Fields: Active, Badge Name, Company Badge, Created By, Created Date, Description, Given Badge Count, Image URL, Last Modified By, Last Modified Date, Limit Number, Limit Per User, Limit Start Date, Owner Name

REPORT: Badges Received

• Fields: Badge, Badge Received Name, Created By, Created Date, Description, Given by, Image, Last Modified By, Last Modified Date, Recipient, Source

REPORT: Thanks

• Fields: Created By, Feed Item, Given by, Last Modified By, Message, Owner Name

REPORT: Assets

• Fields: Account, Asset Name, Competitor Asset, Contact, Created By, Description, Install Date, Last Modified By, Parent Asset, Price, Product, Product Code, Product Description, Product Family, Purchase Date, Quantity, Root Asset, Serial Number, Status, Usage End Date

REPORT: Users

• Fields: About Me, Active, Address, Admin Info Emails, Alias, Allow Forecasting, Call Center, Cell, Chatter Email Highlights Frequency, Company Name, Contact, Default Notification Frequency when Joining Groups, Delegated Approver, Department, Division, Email, Email Encoding, Email Sender Address, Email Sender Name, Email Signature, Employee Number, End of Day, Extension, Fax, Hourly Login Limit, IDE Workspace, Info Emails, Internal Subtype, Is Controlled By System, Language, Locale, Manager, Name, Nickname, Phone, Profile, Role, SAML Federation ID, Start of Day, Stay-in-Touch Email Note, Stay-in-Touch Email Signature, Stay-in-Touch Email Subject, Time Zone, Title, Username

REPORT: Content Version

• Fields: Description, File Type, Language, Owner, Prevent others from sharing and unsharing, Tags, Title

REPORT: Email Messages

• Fields: BCC Address, CC Address, Created By, Created Date, From, From Address, From Name, Has Attachment, Headers, HTML Body, Is Externally Visible, Is Incoming, Last Modified By, Last Modified Date, Message Date, Message Size, Parent Case, Related To, Status, Subject, Text Body, To Address.

 

Salesforce API Docs

https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_what_is_rest_api.htm 

You should not need to reference these API docs very often.

 

FAQs + Tips and Tricks

How do I connect to a Custom Domain?

If your organization uses a custom Salesforce domain, select "Use Custom Domain" when connecting your account. If you aren't already logged into Salesforce and you see an error message upon connecting, open a separate tab in your browser, log into Salesforce, then try connecting again.

What are Saved Report Size Limits?

Salesforce places a limit on the size of some of its reports, depending on your plan and edition of Salesforce. If you are using Salesforce Lightning, Salesforce limits reports to 2,000 rows. If you want to view more details, Salesforce suggests exporting to Excel or using a printable view for tabular and summary reports.

To get around the 2,000-row limit, there are two options:

1. Bring in the data using SOQL instead of using a saved report*.
2. Create your saved report using the Salesforce Classic view.

*Note: Saved reports are only available through Direct Query on Grow. If your data is in the Warehouse, we'd advise you to write your own SOQL query. You can reference Salesforce’s documentation here.

I'm seeing an error "URI Too Long"; what do I do?

While Salesforce allows for a large number of custom fields, they impose a maximum URL length when calling their API. If you encounter this error, and you don't need all of the fields within a given report, the best approach would be to write a custom SOQL query (instructions below) to select only the fields you want for your report.

How do I Write a Custom SOQL Query?

Writing SOQL is an option for those who know how to use Salesforce Object Query Language. For those who know how to write SOQL, it can be helpful in filtering critical data from a Salesforce report or combining multiple Salesforce reports. If you want to learn how to write SOQL, Salesforce provides an introduction here.

Creating a SOQL Statement with Dataloader.io

If you are hitting the 2,000-row limit with saved reports and writing a SOQL query seems daunting, you can use the Dataloader.io service to create a query you can use in Grow. You can use the free version of the service to create a SOQL query.

1. Sign into Dataloader with your Salesforce credentials.
2. Click on "New Task" at the top left, and select "Export".
3. Select the object you want to use for your report and click "Next" at the bottom right.
4. Select the fields you want to bring in, and add any filters and a field to order by (optional).
5. Expand the "SOQL Query" section to see the full query.
6. Copy that query to use in Grow.
7. In Grow, add a new report to a metric, select Salesforce as the data source and choose the "Write SOQL" report type.
8. Paste in the SOQL query you created in Dataloader and click "Get Data".

Here is a brief video that goes through this process of creating a SOQL query:

What's the difference between Salesforce and Salesforce Marketing Cloud?

Grow offers integrations to both Salesforce as well as Salesforce Marketing Cloud. Salesforce offers CRM technologies, allowing companies to manage their customer relations as well as to manage and prioritize tasks and events. Salesforce Marketing Cloud is a digital marketing platform.

Which Salesforce Editions are Accessible through Grow?

In order to access Salesforce in Grow, your organization must be on the Enterprise tier in Salesforce. If you have the Professional Edition and need API access, you will need to contact your Salesforce Account Executive to log a case with Salesforce support. They will enable it for an additional cost.

How do I Removing the Footer info from Salesforce Reports?

Sometimes when you use a saved report or an export from a Salesforce report, you will end up with a footer with information about the report name and when the data was exported, like below:

You could remove this information from the first column by filtering out blanks from Column B for example, but you can also change a setting within Salesforce to stop it from appearing in reports.

To do this, start at Setup, click Customize | Reports & Dashboards | User Interface, then select Export Reports Without Footers.

 

Back to Overview