Benefits of connecting Salesforce to Windmill
Connecting Salesforce to Windmill brings sales and customer-impacting work directly into performance reviews and 1:1s — without requiring reps or managers to manually summarize activity.- Automatically captures deal progress, account work, and follow-through
- Ensures employees get credit for the relationship-building and momentum they drive
- Reduces prep time for performance reviews and calibration cycles
- Helps managers coach more effectively using real customer context
- Makes evaluations more fair, consistent, and grounded in measurable outcomes
Connected data
When Salesforce is connected, Windmill securely reads high-signal revenue and customer interaction data:Windmill reads all Opportunity fields that the integration user can access. This includes custom Opportunity fields. For related records, Windmill reads only the supported fields. Windmill does not sync your full CRM dataset.
Permissions
Windmill requests only two OAuth scopes from Salesforce:Windmill follows least-privilege access and stores only what is necessary for coaching and evaluation.
Connect with a Salesforce integration user
Use a dedicated Salesforce integration user to control the data that Windmill can read. Salesforce calls this user an integration user. Some teams use the term ISU.Create the integration user
Assign the permission set license
Create a Windmill permission set
Grant field-level access
Assign the permission set
Connect Salesforce to Windmill
Object permissions
Grant these object permissions in the Windmill permission set:- Opportunity field history: The user can read it when the user can read the opportunity.
- Tasks and events: The user must have the Access Activities system permission. The user can read a task or an event when the user can read its related record.
- Notes: The user can read a note when the user can read its related record. Windmill reads Salesforce notes and classic notes.
- Users, roles, groups, group members, and opportunity shares: Windmill reads these objects to apply Salesforce sharing. The user can usually read groups, group members, and opportunity shares when the user can read opportunities. Roles need a system permission.
System permissions
Grant these system permissions in the Windmill permission set:View All records
We recommend View All on each object in the Object permissions table. Without View All, the connection is successful, but Windmill syncs only the records that the integration user can see. An integration user usually owns no records, so it sees almost no records. View All does not show all deals to all people in Windmill. Windmill applies Salesforce sharing to each deal. A person sees a deal in Windmill only when that person can see it in Salesforce. Windmill uses these Salesforce settings:- The opportunity owner
- The role hierarchy above the owner
- Opportunity sharing, which includes sharing rules, manual shares, and groups
Field-level access
Grant Read Access to the required fields on each supported object. The following examples are not a complete permission list:Integration users and MFA
Salesforce applies limits to integration users. Read these limits before you create the user.API-only users in orgs that enforce MFA
The Minimum Access - API Only Integrations profile makes the user API-only. An API-only user cannot sign in to the Salesforce UI to register MFA. If your org enforces MFA, the Windmill connect flow stops. Salesforce shows Access Restricted for API Only Users. The Waive Multi-Factor Authentication for Exempt Users permission does not solve this problem after Salesforce enforces MFA for your org. Do one of these:- Contact Salesforce Support to get an MFA exemption for the integration user.
- Connect Windmill with a Salesforce user that can sign in to the Salesforce UI and complete MFA. Give this user the same permissions.
Salesforce Platform license
Do not use a Salesforce Platform user license. This license cannot read opportunities, so Windmill cannot sync deals.Track field changes
The current value of a readable Opportunity field syncs without field history tracking. Enable field history tracking when you also want Windmill to show how a field changed.Open the Opportunity object
Open history tracking settings
Select the fields
Prerequisites
A Salesforce administrator must prepare the integration user. You also need your Salesforce Instance URL.Troubleshooting
Salesforce cannot read the required object "Task", "Event", or "EventRelation"
Salesforce cannot read the required object "Task", "Event", or "EventRelation"
Salesforce cannot read user roles
Salesforce cannot read user roles
Salesforce cannot read the required object or field
Salesforce cannot read the required object or field
Opportunity.Amount. See Object permissions and Field-level access.Access Restricted for API Only Users
Access Restricted for API Only Users
The connection is successful, but few or no deals sync
The connection is successful, but few or no deals sync
FAQs
Does Windmill sync email content from Salesforce?
Does Windmill sync email content from Salesforce?
Can we choose which pipelines, teams, or objects sync?
Can we choose which pipelines, teams, or objects sync?
Do custom Salesforce fields sync?
Do custom Salesforce fields sync?
Do Salesforce custom objects sync?
Do Salesforce custom objects sync?
Does Windmill write anything back into Salesforce?
Does Windmill write anything back into Salesforce?
How often does Windmill sync data?
How often does Windmill sync data?
Is the integration secure?
Is the integration secure?