Salesforce Integration
Connect your Salesforce account to FluxCascade to sync contacts, accounts, opportunities, and leads.
Overview
| Feature | Support |
|---|---|
| Authentication | OAuth 2.0 |
| Objects | Contacts, Accounts, Opportunities, Leads |
| Sync Direction | Bidirectional |
| Real-time Webhooks | ✅ Supported |
Getting Started
Prerequisites
Before connecting Salesforce, ensure you have:
- A Salesforce account (Professional edition or higher)
- System Administrator profile or equivalent permissions
- A FluxCascade account
Step 1: Connect Your Account
- Go to Connections in FluxCascade
- Click Add Connection
- Select Salesforce from the list
- Choose your Salesforce environment:
- Production – Your live Salesforce org
- Sandbox – For testing purposes
- Click Connect with Salesforce
- Sign in to Salesforce and authorize FluxCascade
Step 2: Verify Connection
After connecting, you'll see:
- Connected status with a green indicator
- Your Salesforce org ID
- Instance URL
- Last sync time (if applicable)
Supported Objects
Contacts
Salesforce Contacts are people associated with Accounts.
Standard Fields:
FirstName,LastName,EmailPhone,MobilePhoneMailingAddress(Street, City, State, PostalCode, Country)AccountId,Title,Department
Accounts
Salesforce Accounts are companies or organizations.
Standard Fields:
Name,Website,PhoneBillingAddress,ShippingAddressIndustry,NumberOfEmployees,AnnualRevenueType,OwnerId
Opportunities
Salesforce Opportunities are sales deals.
Standard Fields:
Name,Amount,CloseDateStageName,ProbabilityAccountId,ContactIdType,LeadSource
Leads
Salesforce Leads are potential customers not yet converted.
Standard Fields:
FirstName,LastName,EmailCompany,TitlePhone,MobilePhoneStatus,LeadSource
Field Mapping Examples
Salesforce Contact to HubSpot Contact
| Salesforce Field | HubSpot Field | Notes |
|---|---|---|
FirstName | firstname | Direct mapping |
LastName | lastname | Direct mapping |
Email | email | Direct mapping |
Phone | phone | Direct mapping |
MailingCity | city | Address component |
Account to HubSpot Company
| Salesforce Field | HubSpot Field | Notes |
|---|---|---|
Name | name | Direct mapping |
Website | domain | May need transformation |
Industry | industry | Direct mapping |
NumberOfEmployees | numberofemployees | Direct mapping |
Opportunity Stage Mapping
| Salesforce Stage | HubSpot Stage |
|---|---|
| Prospecting | Appointment Scheduled |
| Qualification | Qualified to Buy |
| Needs Analysis | Presentation Scheduled |
| Value Proposition | Decision Maker Bought-In |
| Perception Analysis | Contract Sent |
| Proposal/Price Quote | Contract Sent |
| Negotiation/Review | Contract Sent |
| Closed Won | Closed Won |
| Closed Lost | Closed Lost |
Custom Objects & Fields
Salesforce custom objects and fields are fully supported:
Custom Fields
- Standard custom fields (
CustomField__c) are auto-discovered - Formula fields are read-only (can be synced to other platforms)
- Lookup and Master-Detail relationships are supported
Custom Objects
- Custom objects (
CustomObject__c) can be synced - Contact your sales team for custom object support
Sandbox Support
For testing, connect a Salesforce Sandbox:
- When connecting, select Sandbox environment
- Use your sandbox credentials
- Test your mappings safely before going to production
Required Permissions
Your Salesforce user needs these permissions:
API EnabledView All Dataor object-specific read permissionsModify All Dataor object-specific write permissions (for write operations)
Rate Limits
Salesforce enforces daily API limits based on your edition:
| Edition | Daily API Calls |
|---|---|
| Professional | 5,000 |
| Enterprise | 100,000 |
| Unlimited | Unlimited |
FluxCascade optimizes API usage with bulk operations when possible.
Troubleshooting
Common Issues
"INVALID_SESSION_ID" error
Your session has expired. Reconnect your Salesforce account.
"INSUFFICIENT_ACCESS" error
Your user doesn't have permission to access the requested object. Check your Salesforce profile permissions.
Custom fields not showing
Refresh your connection to reload the schema. Custom fields must be visible to your user profile.
Reconnecting
If you need to refresh your connection:
- Go to Connections
- Find your Salesforce connection
- Click Disconnect
- Reconnect with the steps above
Getting Help
- Contact support for issues or questions
- Check our changelog for updates
Still Need Help?
Need help? Submit a ticket
Describe your issue and attach screenshots — our team will get back to you.
Next Steps
- Create a mapping between Salesforce and another platform
- Learn about field transformations
- Set up sync schedules