Prerequisites
Before you connect Salesforce, confirm the following:- You have Salesforce System Administrator access (or an equivalent profile with API access enabled) to the org you want to connect.
- Your fsckmsft workspace is on the Pro or Business plan. The Salesforce connector is not available on the Free plan.
- Your Salesforce org has API access enabled. This is on by default for Enterprise and Unlimited editions; Developer Edition orgs also have it enabled.
You can connect one Salesforce org per fsckmsft workspace. To sync multiple orgs, create separate fsckmsft workspaces.
Connect your Salesforce org
Open Integrations settings
In your fsckmsft workspace, navigate to Settings → Integrations → Partner Connectors and click the Salesforce tile.
Authorize the connection
Click Connect Salesforce. You are redirected to the Salesforce OAuth consent screen. Sign in with your Salesforce System Administrator credentials and click Allow.
Select your Salesforce environment
Choose whether you are connecting a Production org or a Sandbox org. Sandbox connections are a good way to test field mappings before going live.
Choose objects to sync
Select which Salesforce objects to sync and which direction data flows.| Salesforce object | fsckmsft object | Sync directions available |
|---|---|---|
| Contacts | Contacts | Salesforce → fsckmsft, fsckmsft → Salesforce, Bidirectional |
| Accounts | Organizations | Salesforce → fsckmsft, fsckmsft → Salesforce, Bidirectional |
| Opportunities | Deals | Salesforce → fsckmsft, fsckmsft → Salesforce, Bidirectional |
Choose sync direction
For each object, select one of the three sync directions. Choose Bidirectional only if you intend to create and update records from both sides.
Configure field mapping
Field mapping controls which Salesforce fields correspond to which fsckmsft fields.Open Field Mapping
On the connector settings page, click Field Mapping next to the object you want to configure.
Review default mappings
fsckmsft pre-populates sensible defaults:
| Salesforce field | fsckmsft field |
|---|---|
FirstName + LastName | Full Name |
Email | Primary Email |
Phone | Phone |
Account.Name | Organization |
Title | Job Title |
Add or edit custom mappings
Click Add Mapping to map additional fields. You can map any Salesforce text, number, date, or picklist field to a corresponding fsckmsft custom field. Drag to reorder the mapping list.
Sync frequency
How often the connector pulls changes from Salesforce. Options:
real-time (webhook-based, Pro plan), every_15_minutes, every_hour, every_day.The initial sync after connection can take several minutes to hours depending on the number of records in your org. fsckmsft displays a progress bar on the connector settings page during the initial sync.
Handle conflicts
A conflict occurs when the same record is updated in both Salesforce and fsckmsft between sync cycles. Configure how conflicts are resolved under Conflict Resolution:| Strategy | Behavior |
|---|---|
| Salesforce wins | Salesforce’s version overwrites fsckmsft. Recommended when Salesforce is your system of record. |
| fsckmsft wins | fsckmsft’s version overwrites Salesforce. Recommended when your team primarily works in fsckmsft. |
| Last write wins | The most recently modified record wins, based on the LastModifiedDate timestamp. |
| Flag for review | Neither side is overwritten. The conflict is surfaced as a notification in fsckmsft for a human to resolve. |