Sync your Salesforce Accounts, Contacts, and Leads into Harvestr so you can measure the business impact of every discovery: ARR, churn risk, plan tier, whatever your CRM tracks. When Sales, CS, or Support submit feedback for a customer, Harvestr already knows who they are and how much they matter.
How the sync works
The Salesforce attribute sync is a one-way, scheduled connection from Salesforce to Harvestr. Two things worth understanding before you set it up.
It's an enrichment layer, not a full CRM import
Harvestr does not import your entire Salesforce Accounts and Contacts database. Instead, for each customer or company that already exists in Harvestr (created manually, imported from another source, or sent alongside feedback from Salesforce, Zendesk, Slack, or any other integration), Harvestr looks for a match in Salesforce and syncs the attributes you selected.
If a Harvestr customer has no match in Salesforce, nothing is imported for them. And Salesforce records that don't match any Harvestr customer are ignored.
Synced customer limits
The Elite plan includes 5,000 synced customers (users and companies combined) by default.
Need more? You can add capacity when you subscribe, or at any point afterwards. Talk to your account manager and they'll set it up.
Prerequisites
A Salesforce account with permissions to create Connected Apps, and read access to the records and metadata you want to sync.
A Harvestr Editor account on an Elite subscription.
Create a Harvestr Connected App in Salesforce
Open the Setup settings in Salesforce.
From Setup, enter External Client Apps in the Quick Find box and select External Client App Settings. Turn on Allow creation of connected apps.
From Setup, enter App Manager in the Quick Find box, select App Manager, then click New Connected App.
Give a name to your integration in the Connected App Name field.
Enter your Contact Email.
Check Enable OAuth Settings.
In Callback URL, paste:
https://api.harvestr.io/authorize/salesforce/callbackIn Selected OAuth Scopes, add these three scopes:
Manage user data via APIs (api)Manage user data via Web browsers (web)Perform requests at any time (refresh_token, offline_access)
Leave the rest as default and click Save.
Wait 10 minutes for the changes to propagate in Salesforce before continuing.
In the left sidebar, under Platform Tools, expand Apps and click Manage Connected Apps. Click your newly created connected app. You should see a page like this:
If not, go to the App Manager section of your Setup settings instead of Manage Connected Apps. Find your app, click the dropdown arrow on the right of the row, and click View.
Under API (Enable OAuth Settings), copy your Consumer Key and your Consumer Secret. If you don't see them directly on this page, click Manage consumer details to reveal them.
That's it for Salesforce. The rest of the setup happens in Harvestr.
Set up attribute sync in Harvestr
Go to Settings > Integrations > Salesforce. If no organization is connected yet, click Connect a Salesforce organization.
In the Users and companies card, under Attribute sync, click Set up attribute sync.
In the Create new Salesforce data sync connection dialog:
enter your Consumer Key and Consumer Secret from Salesforce
tick Is sandbox if you're connecting to a Salesforce sandbox
enter a Replication start date (required)
Click Save and sign in to Salesforce with your admin credentials in the window that opens. Setup usually takes a few seconds.
What is the replication start date? It's a filter that tells the sync which Salesforce records to consider. Any record whose last update in Salesforce is older than this date is ignored. We recommend setting it to about a year back: usually enough for active customers, small enough to skip stale records. You can broaden the range later if you notice missing records.
"Package missing" on your organization? That label refers to the Salesforce feedback widget. If you only use attribute sync, you can ignore it.
If you connected several Salesforce organizations, only one can sync attributes at a time. The others show which organization attribute sync is set up on.
Run the first sync
Once set up, the status box shows Not synced yet. Click Sync now to run the first sync. It can take up to a day, and it keeps running if you leave the page.
Turn on Sync automatically to sync every 48 hours. The status box then shows when the last sync ran, for example Synced 3 hours ago, and how many users and companies it covered.
Match customer records
Each Salesforce object has its own card: Account → Companies, Contact → Users and Lead → Users. The card shows how records are matched, for example Matched by Name. To change it, click Edit on the card and pick an option under Matching rule:
Salesforce object | Harvestr object | Match by |
Account | Company | Name, or a custom unique ID (case sensitive) |
Contact | User | Email, or a custom unique ID (case sensitive) |
Lead | User | Email, or a custom unique ID (case sensitive) |
Name matching compares the exact name stored in Harvestr with five versions of the Salesforce value: as typed, first word capitalized, every word capitalized, upper case and lower case.
Use a custom unique ID when your Salesforce data contains multiple records with the same name (for Accounts) or the same email (for Contacts and Leads). That prevents Harvestr from picking the wrong match.
Heads up if you use custom IDs. The custom ID is imported with the customer only when feedback comes from Salesforce. If the same customer is later matched via feedback from another integration (Zendesk, Slack, and so on), Harvestr falls back to email or name matching. In workspaces with duplicate emails or company names, this may associate feedback with the wrong customer.
Choose which attributes to sync
On each object's card, click Edit. In Select fields to map as custom attributes, pick the fields to bring into Harvestr, then click Save changes. The card then shows the first attributes it syncs.
Under Fields mapping, you can also choose how native fields such as the email or the name are updated: Never synchronize, Synchronize if Harvestr field is empty, or Sync and overwrite Harvestr field if value different from source.
If you create a new attribute in Salesforce after connecting Harvestr, it won't appear in the list right away. Contact our support team and we'll refresh the list for you.
Make Salesforce users and companies searchable when assigning feedback
Each object card has a Searchable when assigning feedback switch. Turn it on to search those Salesforce records when you assign feedback to customers in the Harvestr inbox, the Chrome extension or the Slack feedback form. Salesforce-only results appear with the Salesforce logo next to their names. The change saves right away.
Automatically associate users with their companies from Salesforce
At the top of the Users and companies card, turn on Associate users with their companies, then click Save at the bottom of the page. Harvestr then uses Salesforce as a source of truth to associate users with companies automatically. This setting works even without attribute sync. Only users who don't already have a company in Harvestr are associated this way: existing associations are never overwritten.
Example flow:
You create user A in Harvestr without associating them with any company.
User A belongs to company B in Salesforce.
Harvestr associates user A with company B automatically.
If company B doesn't already exist in Harvestr, it's created automatically.
Manage attribute sync
In the Users and companies card of Settings > Integrations > Salesforce, the ⋯ menu next to the sync status offers:
Refresh status: reload the sync status.
Change sync start date: broaden or narrow the range of Salesforce records considered. The next sync uses the new date.
Delete attribute sync: stop the sync (see below).
To change the Consumer Key, the Consumer Secret or the sandbox setting, delete attribute sync and set it up again.
To sync right away without waiting for the next scheduled run, click Sync now in the status box. If a sync fails, the box shows Last sync failed with a Retry sync button.
To add or remove synced attributes, click Edit on the object's card. If a field you created in Salesforce after setup is missing, contact support and we'll refresh the list.
Delete attribute sync
To stop the sync entirely:
In the Users and companies card, open the ⋯ menu next to the sync status and choose Delete attribute sync.
Confirm.
Attributes that were already synced remain on your customer records but stop updating. Associate users with their companies is not affected. To re-enable the sync later, follow the "Set up attribute sync in Harvestr" steps above: your existing Connected App in Salesforce can be reused.
Leveraging Salesforce customer data to prioritize discoveries
After the first sync completes, the attributes you chose appear on the corresponding customer profiles in Harvestr.
These attributes power Rollup fields, which let you measure the business impact of your discoveries and prioritize them accordingly.
You'll be able to answer questions like:
How much ARR do all customers linked to this discovery represent?
How many users would be impacted by shipping this discovery?
How many churned customers had asked for this?
What's the average deal size of accounts requesting this feature?
FAQ
Why don't I see a new Salesforce attribute in the sync configuration?
If you added or renamed an attribute in Salesforce after setting up the sync, Harvestr's attribute list doesn't refresh automatically. Contact our support team and we'll refresh it for you.
Why aren't all my Salesforce records showing up in Harvestr?
Three common reasons:
Sync start date: any Salesforce record whose last update is older than the date you set is ignored. Broaden the range with ⋯ > Change sync start date if needed.
No matching Harvestr customer: the sync only enriches customers that already exist in Harvestr. Salesforce records without a matching customer are ignored on purpose.
Synced customer limit: check whether you've reached your capacity (see Synced customer limits).
Can I sync more than 5,000 customers?
Yes. Additional capacity can be added at any time, when you subscribe or later on. Talk to your account manager.
Related
Salesforce integration - feedback widget: the other half of the Salesforce integration, for collecting structured feedback from teams working in Salesforce.
Rollup fields: turn synced attributes into prioritization signal.










