Skip to main content

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
Windmill transforms ongoing Salesforce activity into structured insight for coaching, development, and recognition.

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 uses these scopes to read opportunities, accounts, contacts, and activity metadata — it never writes, edits, or deletes any data in 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.
Read Integration users and MFA before you start. If your org enforces MFA (multi-factor authentication), an API-only integration user cannot sign in through the Windmill connect flow.
1

Create the integration user

In Salesforce, create a dedicated integration user. Assign the Salesforce Integration user license and the Minimum Access - API Only Integrations profile. See Give Integration Users API Only Access.
2

Assign the permission set license

Assign the Salesforce API Integration permission set license to the user.
3

Create a Windmill permission set

Create a permission set for Windmill. Grant the object permissions and the system permissions in the tables below.
4

Grant field-level access

In the same permission set, grant Read Access to the fields that Windmill needs. Object access alone is not sufficient. See Field-level access.
5

Assign the permission set

Assign the permission set to the integration user.
6

Connect Salesforce to Windmill

Go to Settings > Integrations in Windmill. Select Salesforce and enter your Salesforce Instance URL. Then, sign in as the integration user.
When you connect, Windmill makes sure that the integration user can read the objects that the sync needs. If an object or a permission is missing, Windmill shows its name. See Troubleshooting.

Object permissions

Grant these object permissions in the Windmill permission set: Some objects do not have a separate object permission in a 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:
If the integration user cannot read tasks and events, the full deal sync fails. Windmill does not sync deals, and not only activities. The connection check also fails, so you cannot connect Salesforce.

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:
Windmill does not sync Salesforce custom objects.

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.
1

Open the Opportunity object

In Salesforce, go to Object Manager and select Opportunity.
2

Open history tracking settings

Go to Fields & Relationships and select Set History Tracking.
3

Select the fields

Select Enable Opportunity History, select the standard and custom fields that you want to track, and save the changes.
Field history tracking applies only from the time that you enable it. It does not create earlier change records.

Prerequisites

A Salesforce administrator must prepare the integration user. You also need your Salesforce Instance URL.

Troubleshooting

The integration user cannot read tasks and events. Give the user the Access Activities system permission.
Give the integration user the View Roles and Role Hierarchy system permission.
The message gives the name of the object or the field. Give the integration user Read access to it. A field name looks like Opportunity.Amount. See Object permissions and Field-level access.
Your org enforces MFA, and the integration user is API-only. See Integration users and MFA.
The integration user can see only a small number of records. Give the user View All on the synced objects. See View All records.

FAQs

No. Windmill syncs metadata (e.g., that a follow-up occurred), not message bodies.
No. Windmill does not provide a pipeline, team, or object selector. The integration syncs supported data for opportunities that the integration user can read. Use Salesforce record access and field permissions to limit the data.
Yes, if they are on the standard Opportunity object and the integration user has Read Access to them. Windmill does not sync custom fields from other objects.
No. Windmill does not sync Salesforce custom objects.
No. The integration is strictly read-only.
Opportunities and related data sync hourly. Users and groups sync daily. Updates appear after a successful sync.
Yes. All data is encrypted in transit and at rest. Windmill maintains SOC 2-level security standards and uses scoped OAuth tokens.