Salesforce Integration
Beta: Salesforce integration is currently in beta. Some features may be limited.
Connect your Salesforce account to FluxCascade to sync contacts, accounts, and opportunities.
Overview
| Feature | Support |
|---|---|
| Authentication | OAuth 2.0 |
| Objects | Contacts, Accounts, Opportunities, Leads |
| Sync Direction | Bidirectional |
| Real-time Webhooks | ๐งช Coming soon |
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
Known Limitations (Beta)
During beta, the following limitations apply:
- No real-time webhooks โ Polling-based sync only
- Limited to 10,000 records per sync โ Contact us for higher limits
- Some standard objects not yet supported โ Including Cases, Tasks, Events
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
As this is a beta integration, we're here to help:
- Contact support for issues or questions
- Join our Discord community for discussions
- Check our changelog for updates
Next Steps
- Create a mapping between Salesforce and another platform
- Learn about field transformations
- Set up sync schedules