This project integrates Drupal with Salesforce, allowing you to synchronize data between Drupal entities and Salesforce objects. It supports both pushing Drupal data to Salesforce and pulling Salesforce data into Drupal, with options for real-time or batch updates.
This suite of modules supports integration with Salesforce by synchronizing Drupal entities (E.g., users, nodes, files) with Salesforce objects (E.g., contacts, organizations, opportunities). It supports pushing Drupal data to Salesforce as well as pulling, or importing, Salesforce data into Drupal. Changes can be made in real time or asynchronously in batches during cron run.
Installing
Get started with Salesforce Quick Start guide
Quick start (recommended install)
composer require drupal/salesforce
drush en salesforce salesforce_jwt salesforce_mapping salesforce_push salesforce_pull salesforce_mapping_ui -y
Requirements
Composer dependencies
- lusitanian/oauth deprecated as of 5.1.3 and removed in 6.0.0
- consolidation/output-formatters required for drush 10 commands
- messageagency/force.com-toolkit-for-php required for salesforce_soap
- firebase/php-jwt required
Note, salesforce_jwt is not vulnerable to CVE-2021-46743. See this comment for more information: #3343671-3: Possible security vulnerability: Increase firebase/php-jwt > 6.0
Drupal module dependencies
Support
- A community documentation page is available on Drupal.org. Please add your notes on solving issues and configuring the module there.
- Please search the issue queue before filing an issue, and update to latest development release to make sure your problem has not already been fixed. Issues filed using the issue summary template will receive priority over other issues.
Drupal 11
Salesforce >= 5.1.1 supports Drupal 11.
New feature development will be focused on Salesforce 6.0.x branch. Some new features may be backported to 5.1.x, but 6.0.x will remain the priority.
Drupal 10
Salesforce 5.1.x will be EOL with Drupal 10 EOL. As long as D10 and D11 are both actively supported, both 5.1.x and 6.0.x branches will be actively maintained.
Modules
- Salesforce Integration (salesforce): wrapper around REST API, Events definitions.
- Salesforce Mapping (salesforce_mapping): Map Drupal entities to Salesforce fields, including field level mapping.
- Salesforce Mapping UI (salesforce_mapping_ui): User interface for building mappings.
- Salesforce Push (salesforce_push): Push Drupal entity updates into Salesforce.
- Salesforce Pull (salesforce_pull): Pull Salesforce object updates into Drupal on cron run. (Salesforce Outbound Notifications are not supported.)
- Salesforce JWT: OAuth JWT authentication support. Recommended auth plugin.
Note, salesforce_jwt is not vulnerable to CVE-2021-46743. See this comment for more information: #3343671-3: Possible security vulnerability: Increase firebase/php-jwt > 6.0 - Salesforce OAuth legacy OAuth User-Agent flow. Deprecated, do not use
- Salesforce Logger: Consolidated logging for Salesforce events.
- Salesforce SOAP: bridge to Salesforce PHP Toolkit SOAP client. This module doesn't do anything on its own, but allows contrib to leverage SOAP features where necessary.
- Salesforce Example (salesforce_example): living documentation for Salesforce Suite API implementations.
Module history
Read some history about Message Agency's work on this module.
This module is in no way affiliated with Salesforce.com, Inc. No endorsement is expressed or implied. Salesforce.com, Inc. and the Salesforce.com logo are trademarks of Salesforce.com, Inc.
Depends on
Dependencies of the latest stable release
No dependencies recorded for this project.
Required by
3 tracked projects depend on this one
- Salesforce OAuth Client credentials Provider 37 sites
- Salesforce OAuth Password Provider 33 sites
- Salesforce Status 16 sites
Activity
Release Timeline
Releases
| Version | Type | Core | Notes | Release date | |
|---|---|---|---|---|---|
| 6.0.0-alpha6 | Pre-release | 11 | Aug 24, 2026 | ||
| 5.1.3 | Stable | 10–11 | Time to switch to salesforce_jwt | Jun 24, 2026 | |
| 6.0.0-alpha5 | Pre-release | 11 | Removes salesforce_oauth module | Jun 12, 2026 | |
| 5.1.3-beta4 | Pre-release | 10–11 | Time to switch to salesforce_jwt | Jun 12, 2026 | |
| 6.0.0-alpha4 | Pre-release | 10–11 | Removes salesforce_oauth module | May 27, 2026 | |
| 5.1.3-beta3 | Pre-release | 10–11 | Time to switch to salesforce_jwt | May 27, 2026 | |
| 5.1.3-beta2 | Pre-release | 10–11 | Time to switch to salesforce_jwt | May 15, 2026 | |
| 6.0.0-alpha3 | Pre-release | 10–11 | Removes salesforce_oauth module | May 15, 2026 | |
| 6.0.0-alpha2 | Pre-release | 10–11 | Removes salesforce_oauth module | May 14, 2026 | |
| 6.0.0-alpha1 | Pre-release | 10–11 | Removes salesforce_oauth module | May 8, 2026 | |
| 5.1.3-beta1 | Pre-release | 10–11 | Time to switch to salesforce_jwt | May 8, 2026 | |
| 6.0.x-dev | Dev | 11 | Removes salesforce_oauth module. Uninstall salesforce_oauth before updating. | May 8, 2026 | |
| 5.0.7 | Stable | 9 | FINAL 5.0.x RELEASE | Mar 18, 2025 | |
| 5.1.2 | Stable | 10–11 | Mar 18, 2025 |